Lookup card information by BIN

Retrieve card information such as network, type, and issuing bank by providing the card's BIN (Bank Identification Number): the first 6 to 11 digits of the card number. Never send the full card number; more than 11 digits is rejected with 400.

The card details are found under the first 6 digits. One 6-digit BIN can be shared by issuers in several countries, so for a Mastercard card looked up with 6 to 11 digits, Astrada also runs a more precise issuer-country check on the digits sent. That check can return a different issuerCountry, issuerRegion and issuerName than the first 6 digits alone would. Send more digits (up to 11) for a more precise issuer country; never send the full card number.

When the digits sent match card ranges in more than one country, the response keeps the 6-digit values and adds issuerCountryAmbiguous, issuerCountryCandidates, and a warnings entry with code ISSUER_COUNTRY_NOT_CONFIRMED. In every other case none of these three fields is present.

Lookups for every other network are unaffected. If the precise check gives no answer, the request still succeeds with the 6-digit values. In sandbox the precise check is not run, so sandbox responses never include these fields.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required
length between 6 and 11
^\d{6,11}$

The first 6 to 11 digits of the card number. Send digits only, and never the full card number. Input that is shorter than 6 digits, longer than 11 digits, or contains anything other than digits is rejected with 400; longer input is not truncated.

For a Mastercard card, send more digits (up to 11) for a more precise issuer country. 11 digits gives the most precise answer.

Headers
string
enum
Defaults to application/hal+json

Generated from available response content types

Allowed:
Responses

Language
Credentials
OAuth2
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/hal+json
application/problem+json