BIN Data API Error Handling

If the BIN Data API fails, you’ll receive an error in the format of the following example:

{"message":[ERROR MESSAGE]}

API Error Messages

Here are the possible values of the Error Message text:

Message	Description
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 support@pagos.ai.	Your trial period has expired. Contact our Support team for continued access.
BIN Data Batch API access is not allowed. Please contact support@pagos.ai	Your account has not been enabled for the BIN Data Batch product. Contact our Support team for access.
This account is suspended. Please contact support@pagos.ai	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 BIN Data API Overview for more details.
Card BIN/IIN not found. Please contact support@pagos.ai	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. Pagos BIN Data is updated weekly.