The Pagos BIN Data API is a very simple REST API that expects to receive—as input—a 6-10 digit BIN/IIN, and returns a simple JSON object back containing known details for the BIN.
If you prefer to query BIN data through your AI tools, check out our guide on the Pagos MCP Server

Generate an API Key

Open the Pagos Service Panel to generate an API Key:
1

Click your profile icon at the bottom of the main navigation.
2

Under Developers, click API Keys.
3

Click the BIN Data API tab.
4

Click Create API Key to add a new key to your account. A side panel will open with the new key value.
5

Copy your new API key and store it somewhere secure. You can only view this value one time.
6

Click I’ve Copied My Key to confirm and exit out of the side panel.
You’ll provide this API key when you make your first BIN Data API request. Pagos uses this value alone to authenticate your request to our servers; you don’t need to provide a password.

Look Up a BIN

We recommend using cURL on the command line to submit BIN Data API requests, but you can also use API query tools like Postman. Here’s a cURL example for details on BIN 55630400
curl -H "x-api-key:[your API key here]" "https://parrot.prod.pagosapi.com/bins?bin=55630400"
This will return the details for the BIN:
{
  "card": {
    "number": {
      "length": 16
    },
    "bin_min": "5563040000000000000",
    "bin_max": "5563049999999999999",
    "card_brand": "MASTERCARD",
    "type": "Credit",
    "prepaid": false,
    "product": {
      "product_id": "MCF",
      "product_name": "Mastercard Corporate Fleet Card"
    },
    "bank": {
      "name": "CITIBANK N.A."
    },
    "country": {
      "alpha2": "US",
      "numeric": "840",
      "name": "UNITED STATES OF AMERICA"
    },
    "correlation_id": "eyJGaWxlSWQiOjI3NiwiVmVyc2lvbiI6NX0="
  }
}

Testing

The Pagos BIN Data API doesn’t have a separate testing environment, but we do provide the ability to test a request and response by submitting a request with a valid API key; to do so, use the BIN: 999999. For example:
curl -H "x-api-key:[your API key here]" "https://parrot.prod.pagosapi.com/bins?bin=999999"
Requests for information on this BIN (999999) won’t count towards your quota or be billed.

Enhanced Data

With the BIN Data API, you can request enhanced data by including the query paramater enhanced=true on you request. This provides you with up to 35 additional fields beyond the standard data fields. It includes additional card brand information, estimated interchange costs, SCA regulation requirements, and more. See the BIN Data API Dictionary for a detailed list of the enhanced data fields available and an example of how BIN data appears in a query response. For example:
curl -H "x-api-key:[your API key here]" "https://parrot.prod.pagosapi.com/bins?bin=999999&enhanced=true"

Brands Covered

At this time, the BIN Data API includes data for the following card brands.

Card Product ID and Name

When available, we will provide the details around the card product ID and the card product name – this will denote the type of card typically present on the BIN. More details are available in the BIN / IIN Product Code Guide.

BIN Data API Limits

The following are the API limits for BIN Data API calls:
BIN Data APIAPI EndpointAPI Limit
Single BIN Lookup/bins100 calls every 10 seconds
Multiple BIN Lookup (50 BINs per API call)/bins/multiple6 calls every 10 seconds

BIN Data API IP Addresses

The following static IP addresses can be used to allowlist API traffic to the Pagos BIN Data API:
  • 99.83.189.213
  • 75.2.25.63

BIN Data API FAQ