跳到主要内容
FinCode

Card BIN / IIN lookup

Resolve a card BIN (the first 6 to 8 digits of a card number) to its brand, type and issuing bank.

本文档适用于 API V1。

Endpoint

Returns the card network, funding type, issuing bank and region membership flags for a BIN. Records are served from the FinCode BIN directory; unknown BINs are resolved through the upstream provider and persisted so later lookups hit the directory directly.

http
GET https://api.ecommica.com/v1/bin/{bin}

Parameters

NameTypeInDescription
binstringpathThe card BIN/IIN — 6 to 8 digits, e.g. 405316.

Example request

bash
curl -s "https://api.ecommica.com/v1/bin/405316" \
  -H "Authorization: Bearer sk_xxx"

Example response

json
{
  "data": {
    "bin": "405316",
    "country_iso2": "US",
    "is_eu": false,
    "is_eea": false,
    "is_sepa": false,
    "country": "United States",
    "brand": "Visa",
    "type": "credit",
    "categories": ["basic"],
    "issuer": "Jpmorgan Chase Bank N.A.",
    "is_valid": true
  },
  "meta": { "request_id": "req_3c9f21b7" }
}

Errors

CodeDescription
INVALID_BINThe BIN is not 6 to 8 digits.
NOT_FOUNDThe identifier does not exist in the dataset.
UNAUTHORIZEDMissing or invalid API key.
RATE_LIMITEDRate limit exceeded — retry after the indicated delay.

Notes

This endpoint is also available anonymously for the website BIN checker and is rate-limited per network address. Pass an API key for higher limits and quota accounting.