List translation memory segments

Learn how to page through the source segments and translations stored in a translation memory using cursor-based pagination.

GET /v3/translation_memories/{translation_memory_id}/segments

List translation memory segments

cURL

curl --request GET \
  --url https://api.deepl.com/v3/translation_memories/{translation_memory_id}/segments \
  --header 'Authorization: <api-key>'

200

Basic

{
  "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": "de",
          "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"
        },
        {
          "target_segment_id": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",
          "target_language": "es",
          "target_text": "Este contrato se rige por las leyes de Alemania.",
          "creation_time": "2026-04-01T16:34:25.223Z",
          "updated_time": "2026-04-01T16:34:25.223Z",
          "last_used_time": "2026-07-22T08:41:05.330Z"
        }
      ]
    }
  ],
  "segment_count": 3542,
  "next_page_cursor": "eyJvZmZzZXQiOjUwfQ"
}

Paginating with cursors

This endpoint pages with an opaque cursor, unlike List translation memories, which uses numbered page values. Omit page_cursor on the first request, then pass each response’s next_page_cursor to get the following page. A response with no next_page_cursor is the last page.

# First page
curl -X GET "https://api.deepl.com/v3/translation_memories/a74d88fb-ed2a-4943-a664-a4512398b994/segments?page_size=50" \
  -H "Authorization: DeepL-Auth-Key <yourAuthKey>"

# Next page, using next_page_cursor from the response above
curl -X GET "https://api.deepl.com/v3/translation_memories/a74d88fb-ed2a-4943-a664-a4512398b994/segments?page_size=50&page_cursor=eyJvZmZzZXQiOjUwfQ" \
  -H "Authorization: DeepL-Auth-Key <yourAuthKey>"

Treat the cursor as opaque. Its format is not part of the API contract, so do not construct, decode, or increment it yourself. Cursors also encode the filter they were issued under: if you change filter_text or filter_case_sensitive, start again without a cursor.

segment_count is the total for the whole translation memory and is not reduced by filter_text. A filtered request still reports the full count, so do not use it to decide how many pages of filtered results to expect. Stop paginating when next_page_cursor is absent.

Filtering

filter_text matches against both source text and every target translation, and must be at least 2 characters. Matching is case-insensitive unless you set filter_case_sensitive=true.

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

translation_memory_id · string<uuid> · required

The ID of the translation memory whose segments you want to list. A unique ID assigned to a translation memory.

Example:

"a74d88fb-ed2a-4943-a664-a4512398b994"

Query Parameters

page_size · integer · default: 50

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

Required range: 1 <= x <= 100

page_cursor · string

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_text · string

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

Minimum string length: 2

filter_case_sensitive · boolean · default: false

Whether filter_text is matched case-sensitively.

Response

200

application/json

Returns a page of segments.

segments · object[] · required

The segments on this page.

Show child attributes

segment_count · integer · 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.

Example:

3542

next_page_cursor · string

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

Example:

"eyJvZmZzZXQiOjUwfQ"