Overview
Batched BIN Data is a file-based product that allows for bulk BIN requests and information retrieval. You can use Batched BIN Data to efficiently retrieve BIN bank and market details via a file you add into your local database—thereby integrating BIN data with any bank or customer analysis you conduct. Batched BIN Data is an in-house alternative to requesting directly from our database via the BIN Data API.
This guide outlines the process of retrieving BIN data for your own local database using Pagos Batched BIN Data.
How it works
- Pagos will create a weekly “snapshot” of our BIN database. This snapshot is comprised of the latest BIN file data and includes all BIN updates.
- Pagos will pre-load the weekly database file for you.
- You will call the /batch/files API to fetch a link to the pre-generated weekly Batch file—including one file for standard BIN data and one file for standard and enhanced BIN data—for download. Within minutes, you'll have a brand new Batch file.
Pagos Batched BIN Data will generate a new batch file every week so you can come back and get a new file as often as you’d like.
Note:
Batched BIN Data generates a new weekly file every Tuesday at 12:00 UTC.
File Changes
When calling the /batch/files API, 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).
Pagos IP Addresses
The following static IP addresses can be used to allowlist API traffic from Pagos:
- 99.83.189.213
- 75.2.25.63