BIN Data API Testing

Ensure your integration with the BIN Data API works correctly by making calls to our simulator in Test Mode. 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:

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

Under Developers, click API Keys.

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

API keys generated in any other tab under Developers—BIN Data API, Action API, and Data Ingestion & Observability API—are legacy keys that will stop working on September 1, 2026.

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

Copy your new API Key and store it somewhere secure.

This is the only time you can view this key!

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://bin.sandbox.pagos.ai/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 Min	BIN Range Max	Network
`4854270000000000000`	`4854279999999999999`	VISA
`4238085010000000000`	`4238085139999999999`	VISA
`4419273340000000000`	`4419279999999999999`	VISA
`4756410010000000000`	`4756410019999999999`	VISA
`4821245300000000000`	`4821245409999999999`	VISA
`4300693100000000000`	`4300693109999999999`	VISA
`6703760000000000000`	`6703769999999999999`	MASTERCARD
`5578061200000000000`	`5578061299999999999`	MASTERCARD
`5407655500000000000`	`5407655599999999999`	MASTERCARD
`5323922500000000000`	`5323922599999999999`	MASTERCARD
`5262597100000000000`	`5262597199999999999`	MASTERCARD
`5154875000000000000`	`5154875099999999999`	MASTERCARD
`3113380000000000000`	`3113389999999999999`	AMEX
`3339600000000000000`	`3339599999999999999`	AMEX
`3344240000000000000`	`3344249999999999999`	AMEX
`3547600000000000000`	`3547609999999999999`	AMEX
`3761510000000000000`	`3761519999999999999`	AMEX
`3763920000000000000`	`3763929999999999999`	AMEX
`6011392800000000000`	`6011392899999999999`	DISCOVER
`6503011700000000000`	`6503011799999999999`	DISCOVER
`6509150000000000000`	`6509159999999999999`	DISCOVER
`6516492200000000000`	`6516492299999999999`	DISCOVER
`6557220000000000000`	`6557229999999999999`	DISCOVER
`6559330000000000000`	`6559339999999999999`	DISCOVER

BIN Data FAQs

BIN Data APIs

BIN Data API Testing

Step 2: Generate Your Test Mode API Keys

Step 3: Test Looking up a BIN

Test Ranges

​Step 1: Create a Pagos Account or Sign In

​Step 2: Generate Your Test Mode API Keys

​Step 3: Test Looking up a BIN

​Test Ranges

Step 1: Create a Pagos Account or Sign In

Step 2: Generate Your Test Mode API Keys

Step 3: Test Looking up a BIN

Test Ranges