RFC 9457

Errors, quotas and retries

Errors use application/problem+json without stack traces. Keep X-Request-ID for support.

400Invalid parameter
401Missing or invalid key
404Unknown resource
429Minute or monthly limit reached
500Internal error with request ID

Quota headers

RateLimit-Limit: 60
RateLimit-Remaining: 42
RateLimit-Reset: 18
X-Monthly-Limit: 1000
X-Monthly-Remaining: 873

After 429, honour Retry-After. Requests producing a 5xx response are refunded from minute and monthly counters.