The server can return the following HTTP status codes:

• 200 – successful method call
• 4xx – incorrect parameters of the method
• 5xx – an error on the server side

The body of the response contains JSON. The standard response formats are described below.

Response format for the status code 200

{
  "taskId": <task guid>,
  "registrationTime": <task creation time>,
  "statusChangeTime": <status change time>,
  "status": <status>,
  "filesCount": <amount of submitted files>,
  "error": <error text>,
  "requestStatusDelay": <recommended delay before next gettaskstatus request in ms>,
  "resultUrls": [
    <url1>,
    <url2>
  ],
  "description": <description>
}

• resultUrls – this attribute is an array that provides up to 3 URLs. The first URL is only available for completed tasks. It contains the result of processing.

  The GET request to download the result should not include any authorization headers. Using your Cloud OCR SDK authorization headers will result in an error.

  The second URL is available for completed tasks which were processed with multiple export formats. It contains the result saved in the second specified format. 

  The third URL is available for completed tasks which were processed with three export formats. It contains the result saved in the third specified format.

  The hyperlinks have limited lifetime. If you want to download the result after that time has passed, use the getTaskStatus or listTasks method to obtain the new hyperlink.
• filesCount – specifies the number of files in the task.
• requestStatusDelay – estimated time until the task is completed (in milliseconds). This attribute is available for the tasks with Queued or InProgress status.
• error – description of the error occurred during processing. This attribute is available for the tasks with ProcessingFailed status only.

We do not recommend sending the same file for processing repeatedly, if the first task failed. However, if you have created several tasks for the same file, and all of them have failed, the fullest and most specific error description can be received by calling getTaskStatus for the first of those tasks.

Response format for the status codes 4xx and 5xx

{
 "error":
 {
    "code":<error internal name>,
    "message":<error message>,
    "target":<target argument>,
    "details":
    [
      {
        "code":<validation error internal name>,
        "target":<target argument>,
        "message":<error message>
      }
    ]
  }
}

• code – an internal unique name of the occurred error. Possible error names are described in the table below.
• message – a human-readable error description.
• target – the request argument causing the error, i.e. in case required taskId argument was not specified, target element will store a value "taskId". This parameter is optional.
• details – an array of error objects, returned for InvalidArgument errors with HTTP response status code 400. Every array element corresponds to one of possible errors in request arguments, i.e. an invalid value of the argument. Every error has its own internal name, returned in the code element, an argument causing the error in target element (optional) and description in the message element. The details element itself is optional.

Status codes and response format

General status codes and response format of the method are described in the table below. 

Below you can find variations of the InvalidArgument error with code 400: