---
title: "List translation memory segments"
method: GET
path: "/v3/translation_memories/{translation_memory_id}/segments"
tags: ["TranslationMemories"]
---

# List translation memory segments

`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`

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](/api-reference/translation-memory/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.

## Path parameters

- `translation_memory_id` string, uuid, required: A unique ID assigned to a translation memory.

## Query parameters

- `page_size` integer
- `page_cursor` string
- `filter_text` string
- `filter_case_sensitive` boolean

## Response `200`

Returns a page of segments.

- object
  - `segments` TranslationMemorySegment[], required: The segments on this page.
    - `source_segment_id` string, required: A unique ID assigned to the source segment.
    - `source_text` string, required: The source text of the segment.
    - `creation_time` string, date-time: The time the segment was added, in the ISO 8601-1:2019 format.
    - `updated_time` string, date-time: The time the segment was last changed, in the ISO 8601-1:2019 format.
    - `last_used_time` string, date-time: The time the segment was last applied to a translation, in the ISO 8601-1:2019 format. Absent if the segment has never been used.
    - `targets` TranslationMemoryTargetSegment[], required: The translations of this source segment, one per target language.
      - `target_segment_id` string, required: A unique ID assigned to the target segment.
      - `target_language` 'ar' | 'bg' | 'cs' | 'da' | 'de' | 'de-ch' | 'de-de' | 'el' | 'en' | 'en-gb' | 'en-us' | 'es' | 'es-419' | 'es-es' | 'et' | 'fi' | 'fr' | 'fr-ca' | 'fr-fr' | 'he' | 'hu' | 'id' | 'it' | 'ja' | 'ko' | 'lt' | 'lv' | 'nb' | 'nl' | 'pl' | 'pt-br' | 'pt-pt' | 'ro' | 'ru' | 'sk' | 'sl' | 'sv' | 'th' | 'tr' | 'uk' | 'vi' | 'zh' | 'zh-hans' | 'zh-hant', required: The list of target languages available in the translation memory. A translation memory's target language must be compatible with the `target_lang` specified in a translation request.
      - `target_text` string, required: The translated text.
      - `creation_time` string, date-time: The time the translation was added, in the ISO 8601-1:2019 format.
      - `updated_time` string, date-time: The time the translation was last changed, in the ISO 8601-1:2019 format.
      - `last_used_time` string, date-time: The time the translation was last applied to a translation request, in the ISO 8601-1:2019 format. Absent if it has never been used.
  - `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.
  - `next_page_cursor` string: The cursor to pass as `page_cursor` to retrieve the next page. Absent on the last page.

## Other responses

- `400`: Bad request. Please check error message and your parameters.
- `401`: Authorization failed. Please supply a valid `DeepL-Auth-Key` via the `Authorization` header.
- `403`: Authorization failed. Please supply a valid `DeepL-Auth-Key` via the `Authorization` header. This error is also returned when the API key is scoped but does not include the scope required for this endpoint.
- `404`: The translation memory could not be found. This is also returned for a translation memory that belongs to another account.
- `429`: Too many requests. Please wait and resend your request.
- `500`: Internal error.
- `503`: Resource currently unavailable. Try again later.

## Changes

- **2026-11-03** `c7c91cfac5c0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/deepl/apis/deepl-api-documentation/changes/v3/translation_memories/:translation_memory_id/segments/get.md)

---

[API](https://skmtc.dev/deepl/apis/deepl-api-documentation.md) - [All operations](https://skmtc.dev/deepl/apis/deepl-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/deepl/apis/deepl-api-documentation/revisions/c7c91cfac5c0?raw)