> ## Documentation Index
> Fetch the complete documentation index at: https://docs.otbstudio.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Fouten

> De foutcodes en HTTP-statussen van de REST API van OTB Studio, wat elk betekent en wat u moet doen, en hoe de MCP-server fouten meldt.

Via REST is elke fout `{"code":"…"}` en niets anders: een vaste code, nooit een zin, zodat u ze voor uw eigen gebruikers kunt vertalen. De [MCP-server](/nl/mcp.md#fouten-en-limieten) meldt een opzoeking zonder resultaat daarentegen als gewoon resultaat; alleen `401` en `429` bereiken een MCP-client als status.

| Code | Status | Betekent | Wat te doen |
| - | - | - | - |
| `missing_token` | 401 | Geen `Authorization: Bearer`-header | Stuur uw API-sleutel mee |
| `invalid_token` | 401 | Onbekende, misvormde of ingetrokken sleutel | Controleer de sleutel, of maak een nieuwe aan |
| `query_required` | 400 | `GET /v1/companies` zonder `q` | Voeg een zoekterm toe |
| `insufficient_credits` | 402 | Geen plan, of het saldo dekt dit antwoord niet | Kies een plan of koop credits bij op [app.otbstudio.ai](https://app.otbstudio.ai) |
| `not_found` | 404 | Geen enkele onderneming heeft dit ondernemingsnummer, of geen enkele route heeft dit pad | Controleer het nummer of het pad |
| `method_not_allowed` | 405 | Het pad bestaat, de methode niet | Elke dataroute is een `GET` |
| `rate_limited` | 429 | Boven de snelheidslimiet van de organisatie, of te veel aanroepen tegelijk | Probeer opnieuw na `Retry-After` seconden |
| `internal` | 500 | Een fout aan onze kant | Probeer opnieuw; elke dataroute is een veilige, idempotente leesbewerking |
| `busy` | 503 | De data konden niet binnen 15 seconden gelezen worden | Probeer opnieuw na `Retry-After` seconden |

Bij een `402` zeggen `X-Credits-Cost` en `X-Credits-Remaining` hoeveel het saldo tekortschoot. Werd de aanroep geweigerd voor hij uitgevoerd werd (geen plan, of een saldo van nul), dan is `X-Credits-Cost` `0`, omdat de prijs dan nog niet bekend is.

De accountroutes die het dashboard gebruikt, hebben nog andere codes. Die maken geen deel uit van een data-integratie.

Vastgelopen? Mail [engineering@otbstudio.ai](mailto:engineering@otbstudio.ai).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.