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"
}
}
]
}Retrieve an import or export job
Learn how to poll a translation memory import or export job and read its status values and results.
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"
}
}
]
}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.
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
Authentication with Authorization header and DeepL-Auth-Key authentication scheme. Example: DeepL-Auth-Key <api-key>
Path Parameters
The identifier of the job, returned when you created the import or export.
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.
The identifier of the job.
"0f8b6c1e-4d2a-4c77-9a3e-1b5d8c9e2f40"
The DeepL product the job belongs to. Always translation_memory.
"translation_memory"
Which kind of job this is.
import, export "import"
The time the job was created, in the ISO 8601-1:2019 format.
"2026-08-06T15:04:25.223Z"
The time the job last changed state, in the ISO 8601-1:2019 format.
"2026-08-06T15:06:11.418Z"
The parameters the job was created with. Import jobs report display_name; export jobs report
translation_memory_id.
Show child attributes
Show child attributes
The job's outcome. This array always holds exactly one entry. It is an array so that jobs producing multiple outputs can be represented without a breaking change.
Show child attributes
Show child attributes
The file declared when the import job was created. Omitted for export jobs.
Show child attributes
Show child attributes