Overview

BIN Data Batch is a file-based product that contains all BINs in a single csv file. You can use BIN Data Batch 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. Batch 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 BIN Data Batch API.

How it works

  1. 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.
  2. Pagos will pre-load the weekly database file for you.
  3. You will call /batch/files 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 will generate a new batch file every week so you can come back and get a new file as often as you’d like.

BIN Data Batch generates a new weekly file every Tuesday at 00:00 UTC.

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