internal_error
Something went wrong on our end. Nothing was emitted.
Something went wrong on our end. Nothing was emitted.
| Code | internal_error |
| Type | api_error — Our fault |
| HTTP | 500 |
| Retriable? | Yes |
What to do
Retry with backoff and the SAME Idempotency-Key. Quote the request_id if it persists.
Retrying the same request may work. Respect Retry-After when it comes.
The envelope
{
"error": {
"type": "api_error",
"code": "internal_error",
"message": "…",
"hint": "Retry with backoff and the SAME `Idempotency-Key`. Quote the `request_id` if it persists.",
"retriable": true,
"doc_url": "https://docs.facturia.cl/errors/internal_error",
"request_id": "req_01K2R7Q9M4T2VB"
}
}Program against code, never against message — the prose can be rewritten, the code cannot (§5.8).
hint and retriable arrive in the response with these exact values: they are a function of code and come from the same dictionary GET /v1/error_codes serves, so the envelope and the dictionary cannot disagree. Both are English on the wire by design — one registry, one language. More in The error envelope.
See also
Every code
The full table, grouped by where you will run into it.
The error envelope
The nine types, the request_id and how to handle them in practice.
The machine-readable copy of this page lives at GET /v1/error_codes, unauthenticated.