This guide outlines the process of retrieving BIN bank and market details for your own local database using Pagos BIN Data Batch API. With the Batch BIN file, you can easily integrate BIN data into any bank or customer analysis you conduct. Batch is an in-house alternative to requesting directly from our database via the BIN Data API.
If you prefer a no-code method for downloading the Batch file, navigate to the Batch tab in the BIN Data section of your Pagos Service Panel.

​
Authentication

The Pagos platform uses API keys to authenticate requests to all our services. See our API Authentication guide for full instructions on generating API keys and authenticating with the Pagos APIs.

​
How it works

  1. Every Tuesday at 00:00 UTC, Pagos generates and publishes a new batch file with the most up-to-date BIN data from the card networks.
  2. Pagos will pre-load the weekly database file for you.
  3. You will call /batch/files to fetch URLs to the following weekly Batch files for download: a Basic file containing only standard BIN data, and an Enhanced file containing both standard and enhanced BIN data.
  4. Follow the URLs to download the files.
These file URLs are only valid for a short period of time and are unique to each call.

​
File Changes

When calling /batch/files, the response will include a changes object, outlining stats on how much the Batch file changed since the previous week. These changes include bins_removed, bins_updated, and bins_added, which provide the number of BIN ranges (rows in the file) that were removed, updated, or added by the card brands Pagos includes data for. For each card brand, we’ll also state what percentage of that brand’s BIN ranges changed (removed, updated, or added).

​
BIN Data Batch IP Addresses

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

​
BIN Data Batch Ranges

When networks issue cards, they generate BINs in ranges. All BINs issued within a set range will share flags indicating card currency, card type (e.g. prepaid, reloadable, etc.), local only, gambling enabled/not supported, etc. Because these flags are set at the range level—not the individual BIN level—Batch BIN Data similarly shares BIN details in ranges between a min and max value. Design your search logic to search for a BIN value within a given range. For example, if you want to review details for BIN 464565, you’d generate the 19-digit value for a card number, padded with zeros; you’d then search for all the rows where the card number 4645650000000000000 is between the bin_min and the bin_max.

​
Testing

You can explore a mock Pagos Batch BIN file in sandbox by enabling Test Mode and following the testing details.