Rate Limiting

In certain cases, Seismic needs to enforce rate-limiting. In the event that a rate limiting policy has been reached, a standard 429 Too Many Requests error will be returned, with an indication of when to retry the request.

❗️

Be aware of the Rate Limiting policy!

The Rate Limiting Policies have been live for several months. We will be STRICTLY enforcing them effective February 27th, 2023.

Please refer to the Versioning and Testing page for testing strategies

Rate Limit Tiers

Tier

Limit

Endpoints

Notes

Tier 1

10 calls per 60 seconds

This has been implemented for the health and performance of the livedoc generation servers

Tier 1.5

30 calls per 60 seconds

This has been implemented for the health and performance of the livesend generation servers

Tier 2

60 calls per 60 seconds

Applied to reduce 'scraping' for file updates. It is recommended to use the Content Search functionality to find documents that are relevant to your needs
Tier 3600 calls per 60 secondsAll others not listed above

429 Response

Response Body
When you hit the rate limit for API, we will return a 429 code. The response will include message, clientId, and tenant name.

{
    "statusCode": 429,
    "message": "Rate limit is exceeded. Try again in 47 seconds.",
    "clientId": "38412620-13c8-40ca-a42b-79b04384790f",
    "tenant": "intdev"
}

Headers

X-Seismic-Remaining-Calls Shows the count of available remaining calls in your 60 second time window
X-Seismic-Total-Calls Shows the count of calls that you have made within your 60 second time window
These headers will be globally available on Feb 27, 2023. Today you can test them with our Testing Domain

📘

Bypass the rate limitations

If you need to bypass the rate limitations in place, please reach out to us at [email protected] and let us know your use case. We will consider temporary exceptions and may even consider permanent exceptions based on your needs.