BIN Data Dictionary

This guide is a repository of information that you can access using Pagos BIN Data and use to refine your payments strategy or get to know your customers better. In BIN Data, there are two types of data fields for which you can receive responses: Standard and Enhanced.

  • Standard Data - Standard BIN data is included in every response for both Pagos BIN Data and Batched BIN Data.
  • Enhanced Data - Enhanced BIN data is available through Batched BIN Data and in Pagos BIN Data when setting the enhanced query parameter to "true".

❗️

Null/Empty Field Responses

The data provided in an individual field response depends on what data appears in the files Pagos receives from the card brands. If a field response is null, this means our network files don't include any data for that field.

Any bool fields marked as "Visa only" will return a true or false value for Visa BINs; for all non-Visa BINs, they'll return a null value.

If you're using Batched BIN Data, see the Batched Data Dictionary.

Standard Data Fields

📘

Table Key

The highest level of data per field is indicated in blue. If there are additional levels of data, the second level is denoted by * and the third level of data is denoted by .

Data Field

Variable Type

Description

Example Response

bank

object

Issuing bank name and details

see nested values

  • name

string

Issuing bank name

"Bank of America National Association"

  • phone

string

Issuing bank phone

"180004321000"

  • url

string

Issuing bank website

"https://www.bankofamerica.com"

bin_min

string

The minimum value of the primary card brand's BIN range in which this BIN value falls

"4225090000000000000"

bin_max

string

The maximum value of the primary card brand's BIN range in which this BIN value falls

"4225099999999999999"

card_brand

string

The name of the card brand

"Mastercard"

card_segment_type

string

Indicator of consumer BIN or
commercial BIN

"consumer"

correlation_id

string

A unique Pagos ID that maps a BIN range to a specific network file; used for troubleshooting

"eyJGaWxlSWQiOjE0NDUsIlZlcnNpb24iOjEwfQ=="

country

object

Issuing country details

see nested values

  • alpha2

string

2 letter country code representing the issuing country; Alpha 2 code meets the ISO3166 standards

"US"

  • numeric

string

Numeric country code representing the issuing country; the numeric country code meets ISO 3166 standards

"840"

  • name

string

Issuing country name

"United States"

number

object

Details about underlying PAN

see nested values

  • length

string

The length of the underlying PAN

"16"

  • luhn

bool

Indicator of the PAN passing Luhn validation

"true"

prepaid

bool

Indicator of a prepaid BIN

"true"

product

object

Details about the card product

see nested values

  • product_id

string

The product ID according to the card brand

"MWE"

  • product_name

string

The product name according to the card brand

"World Elite Mastercard card"

type

string

Indicator of the card type

"Debit"

Here's an example of how Pagos BIN Data returns standard data for the BIN 422509:

"card": {
        "number": {
            "length": 16
        },
        "bin_min": "4225090000000000000",
        "bin_max": "4225099999999999999",
        "card_brand": "VISA",
        "card_segment_type": "Consumer",
        "type": "Debit",
        "prepaid": false,
        "product": {
            "product_id": "F",
            "product_name": "Visa Classic"
        },
        "bank": {
            "name": "CREDIT UNION 1"
        },
        "country": {
            "alpha2": "US",
            "numeric": "840",
            "name": "UNITED STATES OF AMERICA"
        },
        "correlation_id": "eyJGaWxlSWQiOjE0NDUsIlZlcnNpb24iOjEwfQ=="
    }