rate_limit_exceeded

HTTP/1.1 429 Too Many Requests
Content-Type: application/problem+json
Retry-After: 36
X-RateLimit-Limit: 600
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1748535696
X-Request-Id: req_01HV9XK...

{
  "type": "https://docs.digitalseaservice.com/errors/rate_limit_exceeded",
  "title": "Rate limit exceeded",
  "status": 429,
  "detail": "Rate limit of 600 requests exceeded. Retry after 36s.",
  "instance": "req_01HV9XK..."
}

What it means

Your client_id has burned through its per-minute or per-day budget. We return 429 until the sliding window opens back up.

Budgets

Window	Default budget per `client_id`
Per minute	600
Per day	10,000

Both windows apply; the tighter remaining budget wins. Premium-tier partners can negotiate higher limits — talk to your DSS account contact.

Headers on every authenticated response

Every 200, 304, and 429 carries:

Header	Meaning
`X-RateLimit-Limit`	The window’s budget (e.g. `600` for per-minute).
`X-RateLimit-Remaining`	How many requests you have left in this window.
`X-RateLimit-Reset`	Unix timestamp (seconds) when the window resets.

429 also includes Retry-After: <seconds>.

What to do

Respect Retry-After. Wait at least that long before retrying.
Back off, don’t retry tight. A retry loop that ignores Retry-After will keep hitting 429 for the rest of the window.
Use conditional GETs. Pair every read with the prior ETag or Last-Modified — a 304 Not Modified counts as 1 request but returns no body. See Rate limits for the full polling story.
Subscribe to webhooks. They cost zero rate-limit budget. Polling every user every minute will burn your budget fast; webhooks + a conditional GET on receipt is essentially free.

import time

def with_rate_limit_backoff(call):
    while True:
        r = call()
        if r.status_code != 429:
            return r
        delay = int(r.headers.get("Retry-After", "1"))
        time.sleep(max(1, delay))

Get started

Webhooks

Errors

Resources

What it means

Budgets

Headers on every authenticated response

What to do

​What it means

​Budgets

​Headers on every authenticated response

​What to do

​Related

What it means

Budgets

Headers on every authenticated response

What to do

Related