List translation memory segments

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

{
  "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"
}

GET

translation_memories

{translation_memory_id}

segments

List translation memory segments

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

{
  "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

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"

⌘I

Translate

Customize

Voice

Languages

Admin

List translation memory segments

Paginating with cursors

Filtering

Authorizations

Path Parameters

Query Parameters

Response

​Paginating with cursors

​Filtering

Authorizations

Path Parameters

Query Parameters

Response

Paginating with cursors

Filtering