Errors

The API reports errors as JSON with statusCode, reasonPhrase, and message:

json

{
  "statusCode": 400,
  "reasonPhrase": "Bad Request",
  "message": "The processing request's textRecognition config does not include a htrId"
}

Status	When	What to do
`400`	The request body is malformed or incomplete (e.g. missing `htrId`).	Fix the request; compare with the schema in the API Reference.
`401`	The access token is missing, invalid, or expired.	Refresh the token and retry. See Authentication.
`404`	The `processId` or a referenced entity (e.g. model ID) does not exist.	Check the ID; results expire 24 hours after completion.
`408`	Longpoll timeout: no status change within the polling window.	Repeat the request.
`429`	Your account's processing volume is depleted or a usage limit applies.	See Credits and cost.

Errors ​