Error codes / Coduri de eroare
| HTTP |
code |
Meaning |
| 400 |
invalid_request |
a field is malformed — the message names it |
| 400 |
invalid_buyer_vat |
buyer_vat is missing, fails the Romanian check digit, or is not an EU VAT number |
| 400 |
unsupported_version |
the Fintray-Version header names a version we do not serve |
| 401 |
unauthorized |
no valid key (unknown, revoked, or disabled — deliberately indistinguishable) |
| 402 |
quota_exceeded |
this month's usage limit is reached (live keys only) |
| 404 |
not_found |
no such document for this key's account |
| 409 |
idempotency_conflict |
the Idempotency-Key was used for a different request |
| 409 |
not_finished |
the document is still being read (delete, redeliver) |
| 409 |
no_webhook |
no webhook URL on the document or the account |
| 413 |
file_too_large / too_many_pages |
over 14 MiB / over 50 pages |
| 415 |
unsupported_file_type / unsupported_media_type |
not PDF/JPEG/PNG/GIF/WebP / not multipart or JSON |
| 422 |
unreadable_document |
the PDF cannot be opened |
| 429 |
rate_limited |
too many submissions — wait Retry-After seconds |
| any |
error |
an HTTP error with no more specific code (an unknown path, a wrong method) |
On a document that fails (status: failed), error.code is one of:
code |
Meaning |
Retry? |
extraction_failed |
the model could not produce a valid reading of this document |
no — the same file fails the same way |
unreadable_document |
the provider refused the file |
no |
provider_unavailable |
the provider was down; we retried with backoff and gave up |
yes, resubmit later |
file_missing |
the file was deleted before it could be read |
resubmit |
internal_error |
our fault; it has been logged |
resubmit; tell us if it persists |
