Rate Limit
How does the rate limit work?
Every default plan includes 3,000 API calls per entity per hour.
The Motorsport API is organised around entities (e.g. drivers, races, seasons). All requests made to endpoints that belong to the same entity share a single rate limit pool for that entity.
The rate limit starts counting after your first request has been made. It resets back to your original amount when one hour has passed. If your API calls for a specific entity are depleted, you will not be able to make further requests to that entity until the hour resetsl, however, you can still make requests to other entities that have not hit their limit.
Example: If you make your first request at 18:18 UTC, your rate limit for that entity will reset at 19:18 UTC.
Want to learn more about how entities work? Check out our Entities section.
What happens when I hit the rate limit?
Once you've hit the rate limit, you will receive a 429 Too Many Requests response. You can find a full list of response codes on our Response Codes page.
If you find yourself hitting the limit frequently, consider upgrading your plan via my.sportmonks.com.
How can I check how many API requests I have left?
Every API response includes a rate_limit object that gives you real-time visibility into your usage. It contains three properties:
resets_in_seconds
The number of seconds remaining before the rate limit resets for the given entity.
remaining
The number of requests left in the current rate limit timeframe.
requested_entity
The entity that the current rate limit applies to.
Last updated
Was this helpful?