Skip to content

Rate Limiting ​

API requests are rate-limited to ensure fair usage and platform stability.

Limits ​

Endpoint GroupLimit
General API endpointsTo be confirmed — contact support for details

Rate limits apply per workspace.

Rate Limit Headers ​

Each response includes headers that indicate your current rate limit status:

HeaderDescription
X-RateLimit-LimitMaximum number of requests allowed per window
X-RateLimit-RemainingNumber of requests remaining in the current window
Retry-AfterSeconds to wait before retrying (only on 429 responses)

Exceeding the Limit ​

When you exceed the rate limit, the API returns:

json
{
  "message": "Too Many Attempts."
}

Status: 429 Too Many Requests

Best Practices ​

  • Implement exponential backoff when you receive a 429 response
  • Use the Retry-After header value as your delay time
  • Batch requests when possible to reduce total API calls
  • Cache responses for data that doesn't change frequently
  • Monitor your rate limit headers to stay within limits

Increasing Limits ​

If you need higher rate limits for your integration, contact support with your expected usage volume.

Built for virtual address providers requiring USPS 1583 compliance.