> ## Documentation Index
> Fetch the complete documentation index at: https://docs.syntage.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

```bash theme={null}
curl -i 'https://api.syntage.com/entities' \
  --header 'Accept: application/ld+json' \
  --header 'X-Api-Key: {apiKey}'
```

```http theme={null}
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](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/429) response.

```http theme={null}
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](https://app.syntage.com/en/settings/rate-limit).

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](https://support.syntage.com).
