BIN Lookup

The BIN Lookup Service returns BIN attribute information for the payment credential specified in the request. recommends sending the full payment card number (PAN), a TMS token, or a network token to ensure a single BIN record is identified. Sending a six-digit or eight-digit card prefix can result in a MULTIPLE record match error.

Endpoint

POST /bin/v1/binlookup

Include one of these payment credential fields in the request for the BIN Lookup Service:

Field	Type	Description
`paymentInformation.card.number`		View field reference → Set this field to the full payment card number (recommended) or network token.
`paymentInformation.customer.id`		View field reference →
`paymentInformation.instrumentIdentifier.id`		View field reference →
`paymentInformation.paymentInstrument.id`		View field reference →
`tokenInformation.jti`		View field reference →
`tokenInformation.transientTokenJwt`		View field reference →

These fields are optional for a BIN Lookup Service request:

Optional Fields

Field	Type	Description
`paymentAccountInformation.network.id`		View field reference →
`processingInformation.binSource`		View field reference →

Examples

These examples show various BIN lookup requests and successful responses.

Full Payment Card Number

{  "paymentInformation": {    "card": {      "number": "4XXXXXXXXXXXXXXX"    }  }}

{  "id": "7187318127246929204951",  "submitTimeUtc": "2024-06-18T05:30:12Z",  "status": "COMPLETED",  "paymentAccountInformation": {    "card": {      "type": "001",      "brandName": "VISA",      "maxLength": "16",      "credentialType": "PAN"    },    "features": {      "accountFundingSource": "DEBIT",      "cardPlatform": "CONSUMER",      "cardProduct": "Visa Classic"    }  },  "issuerInformation": {    "name": "CONOTOXIA SP. Z O.O",    "country": "PL",    "binLength": "6",    "accountPrefix": "41111111"  }}

Health Card Number

{  "paymentInformation": {    "card": {      "number": "4XXXXXXXXXXXX"    }  }}

{  "id": "7187371922356613504951",  "submitTimeUtc": "2024-06-18T06:59:52Z",  "status": "COMPLETED",  "paymentAccountInformation": {    "card": {      "type": "001",      "brandName": "VISA",      "maxLength": "16",      "currency": "USD",      "credentialType": "PAN"    },    "features": {      "accountFundingSource": "CREDIT",      "cardPlatform": "COMMERCIAL",      "cardProduct": "Visa Purchasing",      "healthCard": true    }  },  "issuerInformation": {    "name": "BANKUNITED, NATIONAL ASSOCIATION",    "country": "US",    "binLength": "6",    "accountPrefix": "42889001"  }}

Network Token

{  "paymentInformation": {    "card": {      "number": "4XXXXXXXXXXXXXXX"    }  }}

{  "id": "6680880793396052804990",  "submitTimeUtc": "2022-11-10T01:47:59Z",  "status": "COMPLETED",  "paymentAccountInformation": {    "card": {      "type": "001",      "brandName": "VISA",      "maxLength": "16",      "credentialType": "TOKEN"    },    "features": {      "accountFundingSource": "DEBIT",      "cardPlatform": "CONSUMER",      "cardProduct": "Visa Classic"    }  },  "issuerInformation": {    "name": "INTL HDQTRS-CENTER OWNED",    "country": "US",    "binLength": "6",    "accountPrefix": "4111111"  }}

Six-Digit Payment Card Prefix

{  "paymentInformation": {    "card": {      "number": "5033961"    }  }}

// This response occurs when multiple account ranges are found with the provided digits.// If you receive this response, provide extended BIN digits to narrow the result to a single range.{  "id": "6445408746306656603955",  "submitTimeUtc": "2022-02-11T12:54:35Z",  "status": "MULTIPLE"}

Eight-Digit Payment Card Prefix

{  "paymentInformation": {    "card": {      "number": "71111111"    }  }}

// This response occurs when a BIN record is not found with the provided digits.{  "id": "6445408746306656603955",  "submitTimeUtc": "2022-02-11T12:54:35Z",  "status": "NO MATCH"}

TMS Customer ID Token

{  "paymentInformation": {    "customer": {      "id": "D0ED44421CDA7A58E053AF598E0AD964"    }  }}

TMS Payment Instrument Token

{  "paymentInformation": {    "paymentInstrument": {      "id": "D0ED44421CD97A58E053AF598E0AD964"    }  }}

TMS Instrument Identifier Token

{  "paymentInformation": {    "instrumentIdentifier": {      "id": "801E10E1B4E2C86AE05341588E0A86EC"    }  }}

TMS jti Transient Token

{  "tokenInformation": {    "jti": "1C26VZRFEIQMOO5H0504KH47I0AM2IZFC43V5L541HBLN9COI3L75F3194E196A1"  }}

Flex API JWT Transient Token

{  "tokenInformation": {    "transientTokenJwt": "eyJraWQ...xxxxx.yyyyy.zzzzz...xZqoGA"  }}

Response Fields

A response for the BIN Lookup Service can include these response fields:

Response Fields

Field	Description
`id`	View field reference →
`issuerInformation.accountPrefix`	View field reference →
`issuerInformation.binLength`	View field reference →
`issuerInformation.country`	View field reference →
`issuerInformation.name`	View field reference →
`issuerInformation.phoneNumber`	View field reference →
`paymentAccountInformation.card.brandName`	View field reference →
`paymentAccountInformation.card.brands.brandName`	View field reference →
`paymentAccountInformation.card.brands.type`	View field reference →
`paymentAccountInformation.card.currency`	View field reference →
`paymentAccountInformation.card.maxLength`	View field reference →
`paymentAccountInformation.card.type`	View field reference →
`paymentAccountInformation.features.acceptanceLevel`	View field reference →
`paymentAccountInformation.features.accountFundingSource`	View field reference →
`paymentAccountInformation.features.accountFundingSourceSubType`	View field reference →
`paymentAccountInformation.features.cardPlatform`	View field reference →
`paymentAccountInformation.features.cardProduct`	View field reference →
`paymentAccountInformation.features.comboCard`	View field reference →
`paymentAccountInformation.features.corporatePurchase`	View field reference →
`paymentAccountInformation.features.healthCard`	View field reference →
`paymentAccountInformation.features.messageType`	View field reference →
`status`	View field reference →
`submitTimeUtc`	View field reference →

Was this page helpful?

Last published: September 29, 2026