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"
}List translation memory segments
Learn how to page through the source segments and translations stored in a translation memory using cursor-based pagination.
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 numberedpage 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>"
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
Authentication with Authorization header and DeepL-Auth-Key authentication scheme. Example: DeepL-Auth-Key <api-key>
Path Parameters
The ID of the translation memory whose segments you want to list. A unique ID assigned to a translation memory.
"a74d88fb-ed2a-4943-a664-a4512398b994"
Query Parameters
The maximum number of segments to return per page. Values above 100 are reduced to 100.
1 <= x <= 100The 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.
Return only segments where this text appears in the source or in any target translation. Must be at least 2 characters.
2Whether filter_text is matched case-sensitively.
Response
Returns a page of segments.
The segments on this page.
Show child attributes
Show child attributes
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.
3542
The cursor to pass as page_cursor to retrieve the next page. Absent on the last page.
"eyJvZmZzZXQiOjUwfQ"