rate_limited

Returned as application/problem+json with code rate_limited and HTTP status 429.

You have made too many requests in the current window.

The response includes a Retry-After header telling you how long to wait.

Common causes

• Request volume exceeded the limit for your API key.

How to resolve

• Wait for the Retry-After interval (seconds), then retry.
• Back off on repeated 429s — the official SDKs do this automatically.

Example

1
{
2
  "type": "https://docs.usglobalmail.com/api/problems/rate_limited",
3
  "title": "Rate limit exceeded.",
4
  "status": 429,
5
  "code": "rate_limited",
6
  "request_id": "req_8f3c2a1b9d",
7
  "instance": "/v1/mails"
8
}

See also: rate-limits.