Rate Limiting

The API enforces rate limits, keyed by your personal access token. Limits vary by endpoint, so don't assume a single number applies everywhere — check your current quota from the response headers instead of a fixed value from documentation:

• X-RateLimit-Limit — your quota for the current window
• X-RateLimit-Remaining — requests left in the current window
• X-RateLimit-Reset — seconds until the window resets

When a request is rejected, the API returns 429 with the standard error envelope:

{
  "meta": {
    "status": "error",
    "errors": [
      {
        "message": "Rate limit exceeded",
        "status_code": 429
      }
    ],
    "warnings": []
  }
}

On a 429, back off exponentially and use X-RateLimit-Reset to know when it's safe to retry, rather than a fixed retry delay.