​
Overview

BIN data can help you better understand both your customers and their preferred payment cards. With this added context, you can design and implement a payments strategy that benefits your bottom line and improves the checkout experience for your customers. All BIN Data API subscribers can access our BIN Data service to submit 6-10 digit bank identification numbers (BINs)—also known as an Issuer Identification number (IIN)—for any customer card; in return, they’ll receive information about the card type and brand, the bank that issued it, and details of the market it was issued in, such as currency, country, and time zone.

Test the BIN Data API Today!

Sign up to get started with a 14-day free trial.

​
Generate an API Key

After you create an account, 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

You’re now ready to query for a BIN! We recommend using cURL on the command line to submit API requests to Pagos, 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="
  }
}

​
BIN Data UI

If you’d prefer a no-code method for performing BIN lookups, navigate to the BIN Data section of your Pagos Service Panel. Learn more in our BIN Data guide.

​
Request BIN Data Via AI Agents

Use the Pagos Model Context Protocol (MCP) Server to allow large language models (LLMs) and AI-powered tools to securely query real-time BIN-level card data. Learn more in our Pagos MCP Server guide.

​
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.

​
Enhanced Data

With the BIN Data API, you can request enhanced data. 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.

​
BIN Data API FAQ