About this endpoint
What it does
Identifies a payment card from its BIN/IIN and returns the card scheme, brand, type, level, issuer, and issuing country.
Query Parameter(s)
| Attribute | Type | Mandatory | Description |
|---|---|---|---|
| bin | String | Yes | 6–8 digit BIN/IIN to look up. |
Response
Returns a JSON object with the request status and a BIN object describing the card -- scheme, type, level, issuer, and issuing country.
| Attribute | Type | Description |
|---|---|---|
| success | Boolean | Whether the request succeeded. |
| code | Integer | Numeric response code. |
| BIN | Object | BIN lookup result. |
| BIN.valid | Boolean | Whether the BIN was recognized. |
| BIN.number | Integer | The BIN as submitted. |
| BIN.length | Integer | Length of the BIN (6 or 8 digits). |
| BIN.scheme / brand | String | Card network (e.g. VISA, MASTERCARD). |
| BIN.type | String | DEBIT, CREDIT, or CHARGE. |
| BIN.level | String | Card tier/level (e.g. PLATINUM, DANKORT). |
| BIN.is_commercial | Boolean | Whether it's a commercial/business card. |
| BIN.is_prepaid | Boolean | Whether it's a prepaid card. |
| BIN.currency | String | Card's billing currency. |
| BIN.issuer | Object | Issuing bank — name, website, phone. |
| BIN.country | Object | Issuing country — name, flag, ISO codes, currency, region, language. |



