$ man card-bin-lookup
/card-bin-lookup(1)
PRICE / CALL
$0.02
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
localeCATEGORY
uncategorized
STATUS
● live
NAME
card-bin-lookup — credit card bin lookup / iin lookup / card-issuer lookup
synonym alias of bin-lookup — reuses the canonical handler.
SYNOPSIS
POST https://x402.org/v1/card-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 lookup / IIN lookup / card-issuer lookup. First 6-8 digits to issuer bank, country, brand (Visa/Mastercard/Amex/Discover/JCB/UnionPay), card type (debit/credit/prepaid). Use for fraud screening, payment routing, geo-risk.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| bin | string | First 6-8 digits of the card number to look up (the BIN/IIN identifying the issuer). | required |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| scheme | string | Card network brand, e.g. Visa, Mastercard, Amex, Discover, JCB, or UnionPay. |
| type | string | Card funding type: debit, credit, or prepaid. |
| country | string | ISO country code of the issuing bank, used for geo-risk and routing. |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.org/v1/card-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 card-bin-lookup tool to ..."
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- localecard-bin-lookupiin-lookupcard-issuerfraud-screeningpayment-routingbin-database
- 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 |
| bin-lookup | Credit card BIN / IIN 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