The Parrot BIN list is a repository of information that you can use to refine your payments strategy and get to know your customers better. In Parrot, 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 Parrot response for both Parrot and Parrot Batch.
• Enhanced Data - For an additional cost, you can submit enhanced data BIN requests via Parrot.

❗️

Null/Empty Field Responses

The data provided in an individual field response depends on what data appears in the files Parrot 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-Via BINs, they'll return a null value.

If you're using Parrot Batch, see the Parrot Batch 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 —.

Here's an example of how Parrot 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=="
    }

Enhanced 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 —.

Here's an example of how Parrot returns enhanced data for the BIN 422509:

{
  "card": {
    "number": {
      "length": 16
    },
    "bin_length": null,
    "bin_min": "3715620000000000000",
    "bin_max": "3715629999999999999",
    "pan_or_token": "pan",
    "level2": false,
    "level3": false,
    "alm": false,
    "account_updater": false,
    "domestic_only": false,
    "gambling_blocked": false,
    "issuer_currency": null,
    "reloadable": true,
    "additional_card_brands": [
      {
        "card_brand": "NYCE",
        "bin_max": "3715999999999999999",
        "bin_min": "3715000000000000000",
        "card_brand_product": "NYCE Generic Product",
        "card_brand_bank_name": null,
        "ecom_enabled": false,
        "billpay_enabled": false
      }
    ],
    "card_brand": "AMEX",
    "card_segment_type": null,
    "combo_card": null,
    "type": "Credit",
    "prepaid": false,
    "product": {
      "product_id": "AX_CONS",
      "product_name": "CONSUMER"
    },
    "bank": {
      "name": "",
      "phone": null,
      "url": null,
      "clean_name": null
    },
    "country": {
      "alpha2": "US",
      "numeric": "840",
      "name": "UNITED STATES OF AMERICA"
    },
    "authentication": {
      "authentication_required": false,
      "authentication_name": null
    },
    "cost": {
      "interchange": {
        "regulated": false,
        "regulated_name": null,
        "domestic": null,
        "inter": null,
        "intra": null,
        "notes": null
      }
    },
    "networkfees": {},
    "correlation_id": "eyJGaWxlSWQiOjY1MzcsIlZlcnNpb24iOjM2fQ==",
    "issuer_supports_tokenization": null,
    "shared_bin": false
  }
}