Errors
Every error is a JSON object with a stable code.
{
"error": {
"code": "invalid_parameter",
"message": "Invalid parameter.",
"details": [{ "path": "company_id", "message": "Required" }]
}
}| HTTP | error.code | Meaning |
|---|---|---|
| 400 | invalid_parameter | Missing, unknown, mistyped or unreadable parameter; malformed JSON body; POST with a query string. details lists the offending paths when known. |
| 401 | unauthorized | Missing, expired or invalid token, or a token not issued through the consent flow. The WWW-Authenticate header points to the discovery document. |
| 404 | not_found | Unknown endpoint (checked after the token). GET /v1 lists the endpoints. |
| 405 | method_not_allowed | Method other than GET or POST. |
| 413 | invalid_parameter | Body larger than 1 MB. |
| 415 | unsupported_media_type | POST body that is not application/json. |
| 429 | rate_limited | Too many requests for this user. Wait for Retry-After seconds. |
| 500 | read_failed | The read failed on the database side. The message is generic; details are in Jolv's logs. |