> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pagos.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# BIN Data API Error Handling

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

```json theme={null}
{"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](#bin-data-api-limits). |
| Trial for this account has ended. Please contact [support@pagos.ai](mailto: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](mailto: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](mailto: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. This also occurs when a key is sent in the wrong header—a unified API key must be sent as `Authorization: Bearer <api key>`. See [API Authentication](/authentication/authentication-overview#authentication). |
| API requires an API key in ‘x-api-key’ header. | Your request didn't include a recognized authentication header. Pass your unified API key as `Authorization: Bearer <api key>`; see [API Authentication](/authentication/authentication-overview). The legacy `x-api-key` header was [retired on September 1, 2026](/authentication/september-2026-api-migration). |
| Card BIN/IIN not found. Please contact [support@pagos.ai](mailto: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. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.