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
}Translate Documents
Check document status
Check whether an uploaded document has finished translating, along with its billed character count and any error.
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
Path Parameters
Body
application/x-www-form-urlencodedapplication/json
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.
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 processedtranslating- the translation is currently ongoingdone- the translation is done and the translated document is ready for downloaderror- an irrecoverable error occurred while translating the document
Available options:
queued, translating, done, error Example:
"done"