Parrot Batch v3 Overview


Parrot Batch Versioning

This reference documentation refers to Parrot Batch API v3. If you're using an earlier version of Parrot Batch, see the Parrot Batch v1 & v2 Overview. If you're unsure which version of Parrot Batch you're using, contact your account manager for assistance.


Parrot Batch is a file-based product that allows for bulk BIN requests and information retrieval. You can use Parrot 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. Parrot Batch is an in-house alternative to requesting directly from our database via the Parrot API.

This guide outlines the Parrot Batch process of retrieving BIN data for your own local database using Parrot Batch v3.

How it works

  1. Parrot Batch v3 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. Parrot Batch v3 will pre-load the weekly database file for you.
  3. 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.

Parrot v3 will generate a new batch file every week so you can come back and get a new file as often as you’d like.



Parrot Batch generates a new weekly file every Tuesday at 0:00 UTC.