Parrot API v3 Overview


Parrot Versioning

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

The Parrot by Pagos BIN service is a very simple REST API that expects to receive—as input—a 6-10 digit BIN/IIN and whether the enhanced data should be included, and returns a simple JSON object back containing known details for the BIN.


Parrot doesn’t have a separate testing environment, but we do provide the ability to test a request and response by submitting a request with a valid API key; to do so, use the BIN: 999999.
Requests for information on this BIN will not use your quota or be billed.

For example:

curl -H "x-api-key:[your API key here]" ""

Error Handling

Any Pagos service errors will be presented in the following way:

{"message":[ERROR MESSAGE]}

Here are the possible values of the ERROR MESSAGE text:

Too many requests. Please try again later.The number of API calls has exceeded our default limits.
Trial for this account has ended. Please contact [email protected]Your trial period has expired. Contact our Support team for continued access.
Batch API access is not allowed. Please contact [email protected]Your account has not been enabled for the Parrot Batch product. Contact our Support team for access.
This account is suspended. Please contact [email protected]Your account is suspended. Contact our Support team for more details.
This API key is invalid.Our system can't validate the provided API key.
API requires an API key in ‘x-api-key’ header.You must pass your API key in the x-api-key header. See Getting Started with Parrot for more details.
Card BIN/IIN not found. Please contact [email protected]We can't find the requested BIN/IIN. This is an indicator that the BIN isn't in our most recent BIN data and is likely no longer in use. Parrot BIN data is updated weekly.

Parrot API Limits

The following are the API limits for Parrot API calls:

Parrot APIAPI EndpointAPI Limit
Single BIN Lookup<>50 calls every 10 seconds
Multiple BIN Lookup (50 BINs per API call)<>3 calls every 10 seconds