Omnist API
Guides

Rate limits and errors

Handle limits, retries, and consistent error responses.

Current API limits are visible in Settings and can be raised. If a request exceeds the current limit, the API returns 429.

Limited requests

HTTP/1.1 429 Too Many Requests
retry-after: 12
x-request-id: req_...

Wait the number of seconds in retry-after before retrying.

Error body

{
  "error": "rate_limited",
  "message": "Rate limit exceeded.",
  "meta": {
    "request_id": "req_..."
  }
}

Common statuses

StatusMeaning
400Invalid request shape, unsupported filter, or invalid date range.
401Missing or invalid authentication.
403Authenticated but not allowed to make this request.
404Resource not found.
429Rate limit exceeded.
5xxServer-side failure. Retry with backoff and keep the request ID.

On this page