getTaskStatus Method

The method returns the current status of the task and the URL of the result of processing for completed tasks. The hyperlink has limited lifetime. If you want to download the result after the time has passed, call the getTaskStatus or listTasks method to obtain the new hyperlink.

See here for the description of all statuses a task can have.

Note: 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 this method for the first of those tasks.

Please note that the task status is not changed momentarily. Do not call this method more frequently than once in 2 or 3 seconds.

Customize the following request URL according to your application processing location:



Parameter Is required Default value Description
taskId Yes No Specifies the identifier of the task. If the task with the specified identifier does not exist or has been deleted, an error is returned.

Status codes and response format

General status codes and response format of the method are described in HTTP Status Codes and Response Formats.

The following status codes can be returned when this method is called:

Code Description
200 Successful method call.
450 Incorrect parameters have been passed. One of the following errors occurred:
  • The identifier of the task has not been specified.
  • There is no task with the specified identifier.

Have more questions? Submit a request



Please sign in to leave a comment.