Skip to main content
GET
Retrieve an import or export job
One endpoint covers both import and export jobs. Read 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

Poll until the status is 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’s operation are omitted rather than returned as null, so check for a field’s presence before reading it:
  • Import jobs include source_file and parameters.display_name. On completion, the result adds translation_memory_id and may add skipped_segment_count.
  • Export jobs include parameters.translation_memory_id. On completion, the result adds download_url and expires_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

​
Authorization
string
header
default:DeepL-Auth-Key
required

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

Path Parameters

​
job_id
string<uuid>
required

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.

​
job_id
string<uuid>
required

The identifier of the job.

Example:

"0f8b6c1e-4d2a-4c77-9a3e-1b5d8c9e2f40"

​
product
string
required

The DeepL product the job belongs to. Always translation_memory.

Example:

"translation_memory"

​
operation
enum<string>
required

Which kind of job this is.

Available options:
import,
export
Example:

"import"

​
creation_time
string<date-time>
required

The time the job was created, in the ISO 8601-1:2019 format.

Example:

"2026-08-06T15:04:25.223Z"

​
updated_time
string<date-time>
required

The time the job last changed state, in the ISO 8601-1:2019 format.

Example:

"2026-08-06T15:06:11.418Z"

​
parameters
object
required

The parameters the job was created with. Import jobs report display_name; export jobs report translation_memory_id.

​
results
object[]
required

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.

​
source_file
object

The file declared when the import job was created. Omitted for export jobs.