enhanced
query parameter to "true"
.
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.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” |
Data Field | Description | Example Response |
---|---|---|
clean_bank_name | Pagos-harmonized bank name that has been formatted to proper case, removes unnecessary punctuation and misspellings, and spells out uncommon banking acronyms | ”American Federal Credit Union” |
bank_url | Issuing bank website | ”https://www.bankofamerica.com” |
bank_phone | Issuing bank phone number | ”180004321000” |
regulated | Indicator of the presence of an interchange regulation on a BIN | ”true” |
regulated_name | The name of the interchange regulation | ”GOVERNMENT NON-EXEMPT INTERCHANGE FEE (WITH FRAUD)“ |
reloadable | Indicator of reloadable or non-reloadable prepaid | ”false” |
pan_or_token | Indicator if the BIN is a PAN or a Network Token. Note: Mastercard uses the same BIN ranges for both PANs and tokens, meaning all Mastercard BINs can be a PAN and will therefore always return pan in this field—even for those that are actually tokens. Refer to the issuer_supports_tokenization field to determine if the BIN supports tokens | ”pan” |
account_updater | (Visa-only field) Account Updater enabled | ”true” |
alm | (Visa-only field) Indicator of a BIN or Account Range participating in Account Level Management | ”true” |
domestic_only | (Visa-only field) Domestic-only BIN or Account Ranges | ”true” |
gambling_blocked | (Visa-only field) Indicator that this BIN is not permitted to be used for online gambling | ”true” |
level2 | (Visa and Mastercard-only field) Indicator of Level 2 interchange rate eligibility | ”true” |
level3 | (Visa and Mastercard-only field) Indicator of Level 3 interchange rate eligibility | ”true” |
issuer_currency | The currency that was issued to this BIN to transact in | ”usd” |
combo_card | Indicator for a card that has combined card type capabilities | ”credit and prepaid” |
bin_length | 6 or 8 digit BIN | ”6” |
authentication | If additional customer authentication is required, this json array will indicate the authentication_name; this field is hardcoded based on issuer country law | ”authentication_name”: “EU PSD2 - SCA” |
cost | Identifies associated costs by name and amount, embedded as JSON in the column | see example below |
additional_card_brands | If the card is associated with a secondary network (e.g. Star, pulse, nyce), this field contains that network’s details; note that secondary network’s typically provide less in their BIN data. | see example below |
issuer_supports_tokenization | Set to true if the card brand data indicates the issuing bank supports network tokenization. Note: The field doesn’t indicate if the associated card actually is a PAN or token, just what it supports | ”true” |
pagos_shared_bin | Set to true if BIN is shared by multiple issuers; more BIN digits may be required in order to get the most accurate BIN details | ”true” |
billpay_enabled | BIN has been enabled to make bill payments to service providers electronically, or over the internet | ”false” |
ecom_enabled | BIN has been enabled to make ecommerce purchases, or purchases over the internet | ”true” |
virtual_card | Set to true if the given BIN range supports virtual card creation. A null response indicates we do not know if there is support for virtual cards | “true” |
funding_source | Indicates the funding source for a payment card, which is different from the type. Note: This field only displays the funding source for Visa and Mastercard; all other brands will show null. | “deferred debit” |
pagos_bin_length | Indicates the length of the BIN as determined by Pagos using the bin_min and bin_max fields provided by the networks. | ”8” |
multi_account_access_indicator | Indicates if a Visa card allows for Flexible Credentials functionality. (Note: This field is only available for Visa cards. All other brands will show null.) The possible values for this field are:
| ”M” |