Rate Limiting

Our API employs a number of safeguards against bursts of incoming traffic to help maximize its stability.

The returned HTTP headers of any API request show your current rate limit status:

curl -i https://api.syntage.com
HTTP/1.1 200 OK
Date: Sun, 29 Nov 2020 19:21:21 GMT
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 56
X-RateLimit-Reset: 1606678044
Header NameDescription
X-RateLimit-LimitThe maximum number of requests you're permitted to make.
X-RateLimit-RemainingThe number of requests remaining in the current rate limit window.
X-RateLimit-ResetThe time at which the current rate limit window resets in UTC epoch seconds.

If you exceed the rate limit, a 429 Too Many Requests response is returned:

HTTP/1.1 429 Too Many Requests
Date: Sun, 29 Nov 2020 19:21:21 GMT
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1606678044

We may reduce limits to prevent abuse, or increase limits to enable high-traffic operations.

You can check your current limits in the dashboard (under Account/Limit).

To request an increased rate limit, please contact support.