DEdeepl
TranslationMemories

Retrieve an import or export job

Changed on

Retrieve the status of a translation memory import or export job.

Poll this endpoint after creating a job. The operation field tells you which kind of job it is, and the single entry in results carries the status and, once the job finishes, its output: the new translation_memory_id for an import, or a download_url for an export.

Requires an API key with the translation_memories:read scope.

get/v3/translation_memories/jobs/{job_id}

Request

  • Base URL
    https://api.deepl.com
  • URL
    https://api.deepl.com/v3/translation_memories/jobs/{job_id}
  • Auth
    API key in header Authorization

Path parameters

job_idstring uuid required

The identifier of the job, returned when you created the import or export.

Response

Returns the current state of the job.

job_idstring uuid required

The identifier of the job.

productstring required

The DeepL product the job belongs to. Always translation_memory.

operation'import' | 'export' required

Which kind of job this is.

creation_timestring date-time required

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

updated_timestring date-time required

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

Example response

{
  "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:06:11.418Z",
  "source_file": {
    "content_type": "application/xml",
    "content_length": 1024
  },
  "parameters": {
    "translation_memory_id": "a74d88fb-ed2a-4943-a664-a4512398b994",
    "display_name": "Legal"
  },
  "results": [
    {
      "status": "completed",
      "status_metadata": {
        "required_action": "Waiting for upload"
      },
      "download_url": "https://assets.deepl.com/download/7c2e5a91-3b8d-4f16-8e0a-6d4c2b7f9a13",
      "expires_at": "2026-08-06T16:05:02.771Z",
      "error": {
        "message": "The uploaded file is not valid TMX."
      },
      "translation_memory_id": "a74d88fb-ed2a-4943-a664-a4512398b994",
      "skipped_segment_count": 12
    }
  ]
}

Changes