POST
/
v2
/
document
/
{document_id}
Check Document Status
curl --request POST \
  --url https://api.deepl.com/v2/document/{document_id} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data document_key=0CB0054F1C132C1625B392EADDA41CB754A742822F6877173029A6C487E7F60A
{
"document_id": "04DE5AD98A02647D83285A36021911C6",
"status": "translating",
"seconds_remaining": 20
}

Authorizations

Authorization
string
header
required

Authentication with Authorization header and DeepL-Auth-Key authentication scheme. Example: DeepL-Auth-Key <api-key>

Path Parameters

document_id
string
required

The document ID that was sent to the client when the document was uploaded to the API.

Body

document_key
string
required

The document encryption key that was sent to the client when the document was uploaded to the API.

Example:

"0CB0054F1C132C1625B392EADDA41CB754A742822F6877173029A6C487E7F60A"

Response

The document status request returns a JSON object containing the document ID that was used in the request as well as string indicating the current status of the translation process. While the translation is running, the estimated number of seconds remaining until the process is done is also included in the response.

document_id
string
required

A unique ID assigned to the uploaded document and the requested translation process. The same ID that was used when requesting the translation status.

Example:

"04DE5AD98A02647D83285A36021911C6"

status
enum<string>
required

A short description of the state the document translation process is currently in. Possible values are:

  • queued - the translation job is waiting in line to be processed
  • translating - the translation is currently ongoing
  • done - the translation is done and the translated document is ready for download
  • error - an irrecoverable error occurred while translating the document
Available options:
queued,
translating,
done,
error
Example:

"done"

seconds_remaining
integer

Estimated number of seconds until the translation is done. This parameter is only included while status is "translating".

billed_characters
integer

The number of characters billed to your account. The characters will only be billed after a successful download request.

Example:

1337

error_message
string

A short description of the error, if available. Note that the content is subject to change. This parameter may be included if an error occurred during translation.

Example:

"Only available if document status is error"