Skip to main content

API Rate Limit

To maintain high availability and ensure fair usage across all users, our API is protected by rate limiting. Each request to the API is counted towards your usage limits, and exceeding these limits will result in 429 Too Many Requests responses.

Rate Limits​

  • Per-Hour Limit: 1,500 requests per hour.
  • Daily Limit: 10,000 requests per day.

Endpoint-Specific Rate Limits​

Some endpoints have additional rate limits beyond the general limits:

EndpointSecondMinuteHourDay
POST /api/v1/shipments/imports20
POST /api/v1/shipments/imports/file20
PATCH /api/v1/shipments/id100
PATCH /api/v1/shipments/reference100

Rate Limit Headers​

Every API response includes the following headers to help you manage your request usage:

  • X-RateLimit-Limit
    The maximum number of requests allowed in the current time window.

  • X-RateLimit-Remaining
    The number of requests you still have available in the current time window.

  • X-RateLimit-Reset
    A UTC timestamp indicating when the rate limit window will reset.

Example Response Headers​

HTTP/1.1 200 OK
Content-Type: application/json
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1724245860

Best Practices​

  • Spread out requests instead of sending them in bursts.
  • Use the X-RateLimit-Remaining and X-RateLimit-Reset headers to adjust request pacing.
  • Implement retries with backoff when receiving 429 Too Many Requests.
Last updated on