API Rate Limits

In an effort to ensure consistent application performance and increased scalability, we have implemented rate limiting on the ShipStation API. Your integration will need to be able to handle HTTP rate limiting status messages as defined below:

Response Headers

All responses will include headers with status information about rate limiting.

x-ratelimit-limit: the maximum number of requests per minute to the endpoint

x-ratelimit-remaining: the available requests remaining in the current window

x-ratelimit-reset: the number of seconds remaining until the next window begins

Hitting the Limit

If your application hits the rate limit, an HTTP 429 will be returned with this body:

{
    statusCode: 429,
    message: 'ThrottlerException: Too Many Requests'
}

When the limit is reached, your application should stop making requests until x-ratelimit-reset seconds have elapsed. The current Rate limit for each set of the API Key and Secret is 40 requests per minute.

Response Headers#

Hitting the Limit#

Response Headers

Hitting the Limit