---
title: "Retrieve Spoken Terms collection details"
method: GET
path: "/v3/spoken-terms/{spoken_terms_id}"
tags: ["ManageSpokenTerms"]
---

# Retrieve Spoken Terms collection details

`GET /v3/spoken-terms/{spoken_terms_id}`

Retrieve metadata for a Spoken Terms collection, including term list information but not the actual terms.

## Path parameters

- `spoken_terms_id` string, required

## Response `200`

JSON object containing the Spoken Terms metadata.

- SpokenTerms
  - `spoken_terms_id` string — A unique ID assigned to the Spoken Terms collection.
  - `name` string — Name of the Spoken Terms collection.
  - `term_lists` SpokenTermsList[] — List of term lists contained in this collection.
    - `lang` string — Language code (ISO 639-1).
    - `entry_count` integer — Number of terms in this list.
  - `creation_time` string, date-time — The creation time of the Spoken Terms collection in ISO 8601-1:2019 format (e.g.: `2025-08-03T14:16:18.329Z`).

## 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` — Forbidden. Authorization failed or feature not available for your plan.
- `404` — The requested resource could not be found.
- `429` — Too many requests. Please wait and resend your request.

---

[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-service-production.skmtc.workers.dev/v1/apis/deepl/deepl-api-documentation/revisions/3c422fcc9c54/schema)