The Parrot by Pagos BIN service is a very simple REST API that expects to receive—as input—a 6-8 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.
curl -H "x-api-key:[your API key here]" "https://parrotv2.prod.pagosapi.com/cards?bin=999999"
Any Pagos service errors will be presented in the following way:
Here are the possible values of the ERROR MESSAGE text:
|Invalid input. BIN/IIN must be a string of numbers of length between 6 and 8.||You have provided an invalid BIN/IIN number.|
|Missing Authentication Token||You either didn't provide an API key or the provided API key is invalid.|
|Your trial period has expired. Please sign up for a plan or contact [email protected]||Your trial period has expired.|
|Exceeded trial period api calls quota. Please sign up for a plan or contact [email protected]||You have exceeded your quota of API calls during the trial period.|
|An internal error has occurred. Please contact [email protected]||Our system has encountered an error retrieving BIN/IIN information.|
|Invalid API key. Please contact [email protected]||Our system can't validate the provided API key.|
|Card BIN/IIN not found. Please contact [email protected]||We can't find the requested BIN/IIN.|
This should be rare. We're always monitoring errors to establish if a data source can be found, but don’t hesitate to contact us if you have questions.