Rate Limiting

To prevent abuse, the Uberflip API uses rate-limiting. There is currently a single rate limit, which applies per set of API credentials (i.e. API Key/Secret pair) and is set at 750 requests/hour.

If you exceed the rate limit, the API will return a 429 Too Many Requests response. We recommend writing your code to gracefully handle receiving a 429 response.

📘

Avoiding 429 Responses

To avoid being affected by rate-limiting, we recommend designing your app to cache data returned by the API whenever possible.

To help you anticipate and avoid 429 responses, every response sent by the Uberflip API includes the following headers:

Header

Description

X-Rate-Limit-Limit

The maximum total number of requests you can make per set of API credentials within the current rate limit time window.

X-Rate-Limit-Remaining

The number of requests you can still make (with the current API credentials) within the current rate limit time window.

X-Rate-Limit-Reset

The time at which the current rate limit time window will reset, given in UTC Unix Epoch time.