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