DEdeepl
TranslationMemories

List translation memory segments

Changed on

List the segments stored in a translation memory, one page at a time. Each entry is a source segment with its translations in every target language.

This endpoint uses cursor-based pagination rather than the numbered pages used by List translation memories. Omit page_cursor on your first call, then pass the next_page_cursor from each response to get the following page. When a response has no next_page_cursor, you have reached the last page.

Requires an API key with the translation_memories:read scope.

get/v3/translation_memories/{translation_memory_id}/segments

Request

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

Path parameters

translation_memory_idstring uuid required

A unique ID assigned to a translation memory.

Example:a74d88fb-ed2a-4943-a664-a4512398b994

The ID of the translation memory whose segments you want to list.

Query parameters

page_sizeinteger

The maximum number of segments to return per page. Values above 100 are reduced to 100.

page_cursorstring

The next_page_cursor from a previous response. Omit this on your first call. Treat the value as opaque: do not build or modify it yourself.

filter_textstring

Return only segments where this text appears in the source or in any target translation. Must be at least 2 characters.

filter_case_sensitiveboolean

Whether filter_text is matched case-sensitively.

Response

Returns a page of segments.

segment_countinteger required

The total number of segments in the translation memory. This is not reduced by filter_text, so a filtered request still reports the full count. Do not use it to predict how many results a filtered query returns.

next_page_cursorstring

The cursor to pass as page_cursor to retrieve the next page. Absent on the last page.

Example response

{
  "segments": [
    {
      "source_segment_id": "4f1c2d3e-8a9b-4c5d-9e6f-7a8b9c0d1e2f",
      "source_text": "This agreement is governed by the laws of Germany.",
      "creation_time": "2026-04-01T16:34:25.223Z",
      "updated_time": "2026-04-01T16:34:25.223Z",
      "last_used_time": "2026-08-05T11:02:18.771Z",
      "targets": [
        {
          "target_segment_id": "9b8a7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
          "target_language": "es",
          "target_text": "Dieser Vertrag unterliegt dem Recht der Bundesrepublik Deutschland.",
          "creation_time": "2026-04-01T16:34:25.223Z",
          "updated_time": "2026-04-01T16:34:25.223Z",
          "last_used_time": "2026-08-05T11:02:18.771Z"
        }
      ]
    }
  ],
  "segment_count": 3542,
  "next_page_cursor": "eyJvZmZzZXQiOjUwfQ"
}

Changes