# Errors and limits Every error says what went wrong and what to do next. Errors and empty answers are free. ## Status codes {#status} | Status | Meaning | What to do | |---|---|---| | 200 | Answered | Read the response and any `message` it provides. An empty answer leaves your allowance unchanged | | 400 | Invalid request | Fix the parameter the message names. Unknown parameters are refused, not ignored | | 401 | Missing or invalid API key | Check the Authorization header and that the key isn't revoked | | 402 | No eligible plan or request allowance exhausted | Start a trial or subscription, wait for the allowance to reset, or switch to a plan with a higher limit | | 403 | API access suspended | Contact support | | 404 | The identifier matches nothing or is ambiguous | Follow the message, such as using `TSCO:LN` instead of `TSCO` | | 429 | Rate limit exceeded | Wait the seconds in Retry-After, then retry | | 500 | Internal error | Retrying the same request is unlikely to help. The error is reported; contact support if it persists | | 503 | Data couldn't be loaded right now | Wait the seconds in Retry-After when present, otherwise retry later with exponential backoff | An error includes an `error` message. Identifier lookups include `match` when Crosswalk supplies an outcome. `not_found` and `ambiguous` return 404. `found` and `no_financial_data` can return a free 200 with an empty collection. ``` { "error": "Nothing matches “ZZZZ”. Check the identifier, or use an ISIN or an exchange-qualified ticker (such as AAPL:US or TSCO:LN).", "match": "not_found" } ``` ## Rate limits {#rate-limits} Your plan allows a number of requests a minute across all your keys and AI assistants: from 120 on Starter to 600 on Scale (see [pricing](https://financialdb.ai/pricing)). Requests over it get a 429 with Retry-After, and aren't counted. ## Monthly request limit {#monthly-limit} Answers with data share one allowance across the REST API and MCP. Once you reach the allowance, requests pause until it resets or you switch to a plan with a higher limit. Check [usage and billing](https://financialdb.ai/documentation/reference/usage-and-billing.md) for details. ## Usage headers {#headers} | Header | Meaning | |---|---| | `X-Usage-Used` | Requests counted this billing period, this one included | | `X-Usage-Included` | Requests your plan includes each period | | `X-RateLimit-Limit` | Requests allowed a minute |