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.
This documentation covers API V1.
On this page
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.