With the public, community-based BIN database that well maintained through thousands of daily BIN corrections from our users, we proudly presents this RESTful API web service to ease out the developmental process for fraud prevention. Through feedbacks of API users, merchants, and developers; the database field arrangement for API as well as its presentation interface layer continue to evolve. Though this public BIN / IIN database is frequently updated, it is not perfect. Please use it with caution.
** Try Premium BIN Checker for up-to-date, accurate BIN Checks.
You can make either HTTP GET or HTTP POST requests to https://api.freebinchecker.com/bin/{bin}
to get the result. The returned format is JSON.
Some good examples of the API requests are:
https://api.freebinchecker.com/bin/371241
https://api.freebinchecker.com/bin/370245
Bad examples:
https://api.freebinchecker.com/bin/AMEX
https://api.freebinchecker.com/bin/debit-card
Parameter | Required | Type | Value | Description |
---|---|---|---|---|
{bin-number} | Yes | string | The BIN or IIN. From 6 to possible 16 digits of a payment card. In the case of duplicate results, the most accurate one will return | |
other parameters | No | string | Under development. Please contact us at dev@freebinchecker.com for ideas and collaborations |
Plain JSON format
Parameter | Type | Value | Description |
---|---|---|---|
valid | boolean | true or false | A valid request |
message | string | optional | Additional information of this specific API call |
card | object | bin, length, luhn check, prepaid, commercial, scheme, type, category | Card Information |
card→bin | string | 370245, etc | The BIN result. In case of duplicate due to long BIN number sent, the most accurate BIN will return and reflect it here |
card→length | string | 15, 16, etc | The number length of this card for the requested BIN |
card→luhn | boolean | true or false | Return the Luhn algorithm of this card for the requested BIN |
card→prepaid | boolean | true or false | Prepaid ? |
card→commercial | boolean | true or false | Commercial ? |
card→scheme | string | AMEX, VISA, MATERCARD, etc | Card issuer company (also called network, brand, scheme) |
card→type | string | "credit", "debit", "charge", etc | Card type classification |
card→category | string | "STANDARD", "VIP", etc | Card category |
issuer | object | name, url, tel, city | Information about the issuer |
issuer→name | string | Bank of America, Chase, Wellsfargo, etc | Name of the card issuer |
issuer→url | string | https://www.freebinchecker.com, etc | URL of the card issuer |
issuer→tel | string | +1 408 434 5454, etc | Telephone of the card issuer |
issuer→city | string | San Francisco, New York, etc | The city where the card issuer located |
country | object | name, alpha-2-code, numberic code, latitude, longitude | Information about issuer country |
country→name | string | United States, China, France, Japan, etc | Name of the card issuer country |
country→alpha-2-code | string | US, CN, FR, JA, etc | Alpha 2 code of the card issuer country |
country→numeric-code | string | 840, 841, etc | Numeric code of the card issuer country |
country→latitude | string | 37.09024, etc | Latitude of the card issuer country |
country→longitude | string | -95.712891, etc | Longitude of the card issuer country |
country→currency | string | USD, EUR, etc | Currency code of the card issuer country |
country→currency name | string | United states dollar, etc | Full Currency name of the card issuer country |
{ "valid": true, "card": { "bin": "370245", "scheme": "AMEX", "type": "credit", "category": "STANDARD" }, "issuer": { "name": "BANESCO BANCO UNIVERSAL S.A.", "url": "www.banesco.com", "tel": "+58 212 501 11 11" }, "country": { "name": "United States", "numeric code": "840", "alpha 2 code": "US", "latitude": "37.09024", "longitude": "-95.712891", "currency": "USD", "currency name": "United States dollar" } }
{ "valid": true, "card": { "bin": "460007", "scheme": "VISA", "type": "debit" }, "issuer": { "name": "METABANK", "url": "bankmeta.com", "tel": "800-554-8969" }, "country": { "name": "United States", "numeric code": "840", "alpha 2 code": "US", "latitude": "37.09024", "longitude": "-95.712891", "currency": "USD", "currency name": "United States dollar" } }