Retrieve an import or export job
curl --request GET \
--url https://api.deepl.com/v3/translation_memories/jobs/{job_id} \
--header 'Authorization: <api-key>'{
"job_id": "0f8b6c1e-4d2a-4c77-9a3e-1b5d8c9e2f40",
"product": "translation_memory",
"operation": "import",
"creation_time": "2026-08-06T15:04:25.223Z",
"updated_time": "2026-08-06T15:04:25.223Z",
"source_file": {
"content_type": "application/xml",
"content_length": 1024
},
"parameters": {
"display_name": "Legal"
},
"results": [
{
"status": "awaiting_input",
"status_metadata": {
"required_action": "Waiting for upload"
}
}
]
}Translation Memory
Retrieve an import or export job
Learn how to poll a translation memory import or export job and read its status values and results.
GET
/
v3
/
translation_memories
/
jobs
/
{job_id}
Retrieve an import or export job
curl --request GET \
--url https://api.deepl.com/v3/translation_memories/jobs/{job_id} \
--header 'Authorization: <api-key>'{
"job_id": "0f8b6c1e-4d2a-4c77-9a3e-1b5d8c9e2f40",
"product": "translation_memory",
"operation": "import",
"creation_time": "2026-08-06T15:04:25.223Z",
"updated_time": "2026-08-06T15:04:25.223Z",
"source_file": {
"content_type": "application/xml",
"content_length": 1024
},
"parameters": {
"display_name": "Legal"
},
"results": [
{
"status": "awaiting_input",
"status_metadata": {
"required_action": "Waiting for upload"
}
}
]
}One endpoint covers both import and export jobs. Read
Poll until the status is
operation to tell them apart, then read results[0] for the status and, once the job finishes, its output.
results always holds exactly one entry. It is an array so that jobs producing multiple outputs can be added later without a breaking change, so index into it rather than assuming a single object.
Status values
| Status | Applies to | Meaning |
|---|---|---|
awaiting_input | Import | The job exists but the file has not been uploaded yet. status_metadata.required_action says what is missing. |
processing | Import, export | The file was received and is being processed. |
completed | Import, export | The job succeeded. Read translation_memory_id (import) or download_url (export). |
failed | Import, export | The job did not finish. error.message says why. |
expired | Import, export | The job is too old to act on. Create a new one. |
completed, failed, or expired. The other states are transient and will change on their own.
Which fields to expect
Fields that do not apply to a job’soperation are omitted rather than returned as null, so check for a field’s presence before reading it:
- Import jobs include
source_fileandparameters.display_name. On completion, the result addstranslation_memory_idand may addskipped_segment_count. - Export jobs include
parameters.translation_memory_id. On completion, the result addsdownload_urlandexpires_at.
An import that sits at
awaiting_input means DeepL is still waiting for the file. Upload it to the upload_url from the import response; the status will not advance on its own.Authorizations
Path Parameters
Response
Returns the current state of the job.
The state of a translation memory import or export job. Fields that do not apply to the job's
operation are omitted.