Errors
Errors look like:
{ "error": { "code": "invalid_request", "message": "Check the request.", "issues": ["insured.state: Too small: expected string to have >=2 characters"] } }message is plain English you can show a person. issues appears on validation errors.
| Status | Code | Meaning | Retry? |
|---|---|---|---|
| 400 | invalid_request |
A field is missing, wrong or unknown; see issues |
No: fix the request |
| 400 | invalid_json |
The body isn’t JSON | No: fix the request |
| 401 | unauthorized |
Key or token missing, wrong, expired or revoked | No: get a new key or sign in again |
| 403 | read_only |
A read key tried to submit | No: use a read-and-submit key |
| 403 | agency_not_active |
No signed broker agreement yet | No: talk to your broker |
| 403 | not_offered |
Instant quotes are off | No |
| 403 | forbidden |
API access is off for your agency | No |
| 404 | not_found |
Not found, or not your agency’s | No |
| 409 | closed |
The file is closed | No |
| 409 | not_open |
The file isn’t being marketed any more | No |
| 409 | quote_expired |
The quote expired | No: ask your broker to refresh it |
| 409 | already_requested |
A bind request is already open for the quote | No |
| 409 | no_instant_market |
No connected market fits | No: your broker markets it |
| 409 | limit |
5 webhooks already | No: delete one first |
| 409 | not_withdrawable |
The bind request already went to the market | No: call your broker |
| 409 | ai_off |
Plain-sentence answers aren’t switched on yet | No: send answers by key |
| 413 | too_large |
Body over 64 KB, file over 4 MB direct or 25 MB by link | No: use an upload link |
| 415 | unsupported_type |
File type not accepted | No |
| 429 | rate_limited |
Over 120 requests a minute for the key (30 per IP on public endpoints), counted across all of Valjean’s servers | Yes, after Retry-After seconds |
| 500 | server_error |
Something went wrong on Valjean’s side | Yes, later; creates are safe with client_reference or Idempotency-Key |
| 503 | ai_unavailable |
The message couldn’t be read just now | Yes, shortly; or send answers by key |