Errors

Errors are returned as JSON with a stable code.

{
  "error": "rate_limited",
  "message": "Too many requests.",
  "request_id": "req_01HZW..."
}

Codes

code	status	meaning
`invalid_request`	400	Body or query failed validation.
`unauthorized`	401	Missing or invalid API key.
`forbidden`	403	Key lacks the required scope or IP not allowed.
`not_found`	404	Resource does not exist or has been hard-deleted.
`conflict`	409	Duplicate, e.g. address already exists.
`rate_limited`	429	Exceeded rate limit. See Retry-After.
`server_error`	500	Internal error. Safe to retry with backoff.
`unavailable`	503	Upstream subsystem degraded. Check /status.