Get started
Errors
Failures return standard HTTP statuses with a small JSON body. The Python SDK maps these to typed exceptions.
Status codes
| HTTP | Meaning | When |
|---|---|---|
| 401 | Unauthorized | Missing or invalid API key. |
| 404 | Not found | Ticker, market_id, or filing_id does not exist in the index. |
| 429 | Too many requests | Daily or monthly quota exceeded. Resets at UTC midnight (daily) or on the 1st (monthly). |
| 502 | Upstream error | Registry temporarily unavailable. Retry after a few minutes. |
Example body
Quota responses include a stable error string:
{
"detail": { "error": "quota_exceeded", "dimension": "daily" }
}Retry guidance
429— daily or monthly allotment spent. Wait for the next window, or see Rate limits for402when the prepaid balance cannot cover the call.502— upstream registry blip; exponential backoff a few minutes is usually enough.401— the request had no acceptedX-API-Key. Check the header on API keys.