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
| Name | Type | In | Description |
|---|---|---|---|
| bin | string | path | The 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
| Code | Description |
|---|---|
| INVALID_BIN | The BIN is not 6 to 8 digits. |
| NOT_FOUND | The identifier does not exist in the dataset. |
| UNAUTHORIZED | Missing or invalid API key. |
| RATE_LIMITED | Rate 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.