A
A
API 3.0 (BETA)
Football API 3.0 (BETA)
Search…
⌃K

Rate limit

How does the rate limit work?

Every default plan has 3000 API calls per entity per hour.
For example: the teams entity is used in multiple teams endpoints. This means that all the requests made from the team endpoints count for the same entity: teams.
The rate limit kicks in after the first request has been made. The rate limit will be set to 0 when an hour has passed. Until the hour is finished, you will not be able to request data from the entity for which you surpassed the rate limit.
For example: If you make the first of your requests at 18:18 UTC it will be reset at 19:18.
Want to learn more about entities? Check our entities section.

What happens when I hit the rate limit?

Once you’ve hit the rate limit, you will receive a 429 response. You can check all response codes on our response codes page. If you reach the limit quite often, it might be interesting to upgrade the number of API calls via my.sportmonks.

How can I find how many API requests I have left?

When you make a request, the API response includes a header called 'x-ratelimit-remaining', this marks your remaining number of requests for that hour.
Furthermore, information about the current number of calls can be found in the response meta section.