BIN Lookup

GET {{baseUrl}}/bin-lookup?bin-number=<string>&customer-ip=<string>

Perform a BIN (Bank Identification Number) or IIN (Issuer Identification Number) lookup

Request Params

KeyDatatypeRequiredDescription
bin-numberstring(Required) The BIN or IIN number. This is the first 6, 8 or 10 digits of a card number, use 8 (or more) digits for the highest level of accuracy
customer-ipstringPass in the customers IP address and we will return some extra information about them

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;country&quot;:&quot;\u003cstring\u003e&quot;,&quot;ip-city&quot;:&quot;\u003cstring\u003e&quot;,&quot;ip-matches-bin&quot;:&quot;\u003cboolean\u003e&quot;,&quot;card-type&quot;:&quot;\u003cstring\u003e&quot;,&quot;card-category&quot;:&quot;\u003cstring\u003e&quot;,&quot;ip-country-code&quot;:&quot;\u003cstring\u003e&quot;,&quot;ip-country&quot;:&quot;\u003cstring\u003e&quot;,&quot;issuer&quot;:&quot;\u003cstring\u003e&quot;,&quot;ip-blocklisted&quot;:&quot;\u003cboolean\u003e&quot;,&quot;valid&quot;:&quot;\u003cboolean\u003e&quot;,&quot;ip-blocklists&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;issuer-website&quot;:&quot;\u003cstring\u003e&quot;,&quot;country-code&quot;:&quot;\u003cstring\u003e&quot;,&quot;ip-region&quot;:&quot;\u003cstring\u003e&quot;,&quot;card-brand&quot;:&quot;\u003cstring\u003e&quot;,&quot;issuer-phone&quot;:&quot;\u003cstring\u003e&quot;,&quot;country-code3&quot;:&quot;\u003cstring\u003e&quot;,&quot;currency-code&quot;:&quot;\u003cstring\u003e&quot;,&quot;ip-country-code3&quot;:&quot;\u003cstring\u003e&quot;,&quot;is-commercial&quot;:&quot;\u003cboolean\u003e&quot;,&quot;is-prepaid&quot;:&quot;\u003cboolean\u003e&quot;,&quot;bin-number&quot;:&quot;\u003cstring\u003e&quot;}