Skip to main content
Syntage applies rate limits to protect API stability and keep service available for all organizations. Rate limits are enforced per API key and endpoint.

​
Rate limit headers

Every API response includes headers that show your current rate limit status. 
curl -i 'https://api.syntage.com/entities' \
  --header 'Accept: application/ld+json' \
  --header 'X-Api-Key: {apiKey}'

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.

​
Exceeding the limit

If you exceed the rate limit, the API returns a 429 Too Many Requests response. 
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
When you receive a 429 response, wait until the time in X-RateLimit-Reset before retrying. Avoid retry loops that immediately repeat the same request, because they can continue consuming capacity and delay recovery.

​
Current limits

You can check your organization’s current limits in the Rate Limit settings page. Syntage may reduce limits to prevent abuse or increase limits to support approved high-traffic operations. To request an increased rate limit, please contact support.