$ man bin-lookup
/bin-lookup(1)
PRICE / CALL
$0.02
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
localeCATEGORY
utilities
STATUS
● live
NAME
bin-lookup — credit card bin / iin lookup
SYNOPSIS
POST https://x402.org/v1/bin-lookup
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Credit card BIN / IIN lookup. First 6-8 digits identify issuing bank, country, brand (Visa/Mastercard/Amex), card type (debit/credit/prepaid). Fraud screening, payment routing, geo-risk. Powered by binlist.net.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| bin | string | 6-8 digit BIN. NEVER pass full card numbers — PCI scope risk. | required |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| bin | string | First 6-8 digits of the card number used for the lookup. |
| scheme | string | Card network scheme such as visa, mastercard, amex, discover, or jcb. |
| type | string | Card type indicator: debit, credit, or charge. |
| brand | string | Specific product brand within the scheme, like Visa Classic, World Elite, or Platinum. |
| prepaid | boolean | True if the BIN identifies a prepaid card, false for funded credit/debit accounts. |
| card_number | object | Card number metadata: length and whether the Luhn checksum applies. |
| country | object | Issuing country block with ISO alpha-2/alpha-3 codes, name, emoji, currency, and lat/lon. |
| issuer | object | Issuing bank details including name, website URL, and customer phone where known. |
| source | string | Upstream data source for the lookup, typically binlist.net. |
| note | string | Optional note about data freshness, partial matches, or fallback behavior. |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.org/v1/bin-lookup \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# install once claude mcp add x402 --command "npx x402-deployer-mcp" # then ask Claude Code: # "use the bin-lookup tool to ..."
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- biniincredit-cardfraudpaymentskyc
- methods
- POST
- cluster
- locale
- price
- $0.02 USDC per call
ADJACENT — other endpoints in locale
| endpoint | description | price |
|---|---|---|
| address-geocode | Geocoder / address-to-lat-lng / location resolver. | $0.02 |
| airport-delays | FAA NAS Status — current US airport delays, ground stops, ground delay programs, weather-driven program changes. | $0.02 |
| card-bin-lookup | Credit card BIN lookup / IIN lookup / card-issuer lookup. | $0.02 |
| reverse-geocode | Reverse geocoder / lat-lng-to-address. | $0.02 |
| satellite-bbox | Bounding-box satellite composite / Sentinel-2 cloud-free mosaic / region satellite snapshot / arbitrary bbox to imagery. | $0.02 |
| building-permits | Building permits multi-city open-data lookup. | $0.03 |
| flight-status | Flight status / live aircraft position / flight tracker / ICAO24 lookup / callsign lookup / aircraft bounding-box / OpenSky Network state… | $0.01 |
| property-tax | Property tax lookup. | $0.01 |
SEE ALSO