Skip to main content
Ensure your integration with the BIN Data API works correctly by making calls to our simulator in Test Mode.

​
Step 1: Create a Pagos Account or Sign In

If you’re interested in the BIN Data API, you can try it out in Test Mode. Sign up for a Pagos account or log into your existing account, then click the environment toggle in the top-right corner; a yellow bar will appear across the top of the Pagos Service Panel to confirm you’re in Test Mode.

​
Step 2: Generate Your Test Mode API Keys

In Test Mode, generate an API Key for the BIN Data API.
These API Keys are universal across Test Mode and will be used for testing all Pagos API products. If you’ve already created an API key in Test Mode, you don’t need to create a new one.
To generate your API key:
1

Click your settings icon in the top-right corner of your Pagos Service Panel.
2

Under Developers, click API Keys.
3

In the API Keys tab, click Create API Key to add a new key to your account.
4

In the side panel that opens, set your Key Name, then click Create API Key.
5

Copy your new API Key and store it somewhere secure.
This is the only time you can view this key!
6

Click I’ve Copied My Keys to confirm and exit the side panel.

​
Step 3: Test Looking up a BIN

Use our test ranges to test looking up a BIN in Test Mode. Note that the endpoint for Test Mode points to sandbox. 
curl --request GET \
  --url 'https://parrot.sandbox.pagosapi.com/bins?enhanced=true&bin=485427' \
  --header 'Authorization:Bearer <api_key>'
This will return the mock details for the BIN: 
{
  "card": {
    "number": {
      "length": 16
    },
    "bin_length": 6,
    "pagos_bin_length": 6,
    "bin_min": "4854270000000000000",
    "bin_max": "4854279999999999999",
    "pan_or_token": "pan",
    "virtual_card": null,
    "level2": false,
    "level3": false,
    "alm": false,
    "account_updater": true,
    "domestic_only": false,
    "gambling_blocked": false,
    "issuer_currency": "USD",
    "reloadable": false,
    "additional_card_brands": [
      {
        "card_brand": "PULSE",
        "bin_max": "4854279999999999999",
        "bin_min": "4854270000000000000",
        "card_brand_product": null,
        "card_brand_bank_name": null,
        "ecom_enabled": true,
        "billpay_enabled": true
      }
    ],
    "card_brand": "VISA",
    "card_segment_type": "Business",
    "combo_card": null,
    "type": "Debit",
    "funding_source": "DEBIT",
    "prepaid": false,
    "product": {
      "product_id": "G",
      "product_name": "Visa Business"
    },
    "bank": {
      "name": "SPACE COAST CREDIT UNION",
      "phone": null,
      "url": null,
      "clean_name": "Space Coast Credit Union"
    },
    "country": {
      "alpha2": "US",
      "numeric": "840",
      "name": "UNITED STATES OF AMERICA"
    },
    "authentication": {
      "authentication_required": false,
      "authentication_name": null
    },
    "cost": {
      "interchange": {
        "regulated": false,
        "regulated_name": "GOVERNMENT EXEMPT INTERCHANGE FEE",
        "domestic": null,
        "inter": null,
        "intra": null,
        "notes": null
      }
    },
    "networkfees": {},
    "correlation_id": "eyJGaWxlSWQiOjIzMDc5LCJWZXJzaW9uIjoyNDAyfQ==",
    "issuer_supports_tokenization": null,
    "multi_account_access_indicator": "N",
    "shared_bin": false
  }
}

​
Test Ranges

Use any BIN, first 6 to 10 digits, that fall within the below min and max bin ranges by network for testing.
BIN Range MinBIN Range MaxNetwork
48542700000000000004854279999999999999VISA
42380850100000000004238085139999999999VISA
44192733400000000004419279999999999999VISA
47564100100000000004756410019999999999VISA
48212453000000000004821245409999999999VISA
43006931000000000004300693109999999999VISA
67037600000000000006703769999999999999MASTERCARD
55780612000000000005578061299999999999MASTERCARD
54076555000000000005407655599999999999MASTERCARD
53239225000000000005323922599999999999MASTERCARD
52625971000000000005262597199999999999MASTERCARD
51548750000000000005154875099999999999MASTERCARD
31133800000000000003113389999999999999AMEX
33396000000000000003339599999999999999AMEX
33442400000000000003344249999999999999AMEX
35476000000000000003547609999999999999AMEX
37615100000000000003761519999999999999AMEX
37639200000000000003763929999999999999AMEX
60113928000000000006011392899999999999DISCOVER
65030117000000000006503011799999999999DISCOVER
65091500000000000006509159999999999999DISCOVER
65164922000000000006516492299999999999DISCOVER
65572200000000000006557229999999999999DISCOVER
65593300000000000006559339999999999999DISCOVER