Rate Limiting

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 Name	Description
X-RateLimit-Limit	The maximum number of requests you’re permitted to make.
X-RateLimit-Remaining	The number of requests remaining in the current rate limit window.
X-RateLimit-Reset	The 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.

Start here

API concepts

Integration guides

Rate limit headers

Exceeding the limit

Current limits

​Rate limit headers

​Exceeding the limit

​Current limits

Rate limit headers

Exceeding the limit

Current limits