Bolcho Docs Back to app

Reference

Errors & status codes

The API uses standard HTTP status codes. Error responses are JSON with a message.

json
{ "statusCode": 400, "error": "Bad Request", "message": "Enter a valid E.164 number" }

Status codes

200 / 201 — success.
204 — success, no content.
400 — invalid request (validation, bad SIP config, etc.).
401 — missing/invalid API key.
403 — key lacks the required scope.
404 — resource not found.
409 — conflict (e.g. duplicate).
429 — rate limited (120 req/min default).
500 — server error.

Rate limits: 120 requests/minute per key by default. Handle 429 with exponential backoff.