How daily quotas work

Each plan has a limit of requests per day. This article explains how we count the requests.

The daily limit

Your plan name shows the number of lookups per month. The API applies the limit per day. For example, the BLAPI-30KPM plan permits 1,000 requests each day.

Reset time

The counter resets at 00:00 UTC each day. Unused requests do not carry over to the next day.

What counts as one unit

• One single lookup uses one unit.
• Each BIN in a batch request uses one unit.
• Each row in a batch CSV file uses one unit.

Shared quota

All API keys of an organisation share the same quota.

When you reach the limit

The API returns the error QUOTA_EXCEEDED with HTTP status 429. Requests continue after the reset.

When you upgrade your plan

The new daily limit applies immediately. The requests that you made earlier in the day still count.

How to see your remaining quota

• Read the X-Quota-Remaining header in each response. See Quota headers.
• Check the Remaining statistic on the dashboard home page.