♾️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 starts counting after the first request has been made. The rate limit will reset back to your original amount when an hour has passed. When your API calls are depleted, until the hour is finished, you will not be able to request data from the entity for which you surpassed the rate limit[1] . You can however make requests to other entities that have not hit 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 rate_limit object in the response, this object has 3 properties:

PropertyMeaning

resets_in_seconds

The amount of seconds remaining in before your rate limits resets for the given entity.

remaining

The amount of requests left in the current rate limit timeframe.

requested_entity

The entity that the rate limit for your current request applies on.

Last updated