---
title: "Get Metadata For A Pronunciation Dictionary"
method: GET
path: "/v1/pronunciation-dictionaries/{pronunciation_dictionary_id}"
tags: ["Pronunciation Dictionary"]
---

# Get Metadata For A Pronunciation Dictionary

`GET /v1/pronunciation-dictionaries/{pronunciation_dictionary_id}`

## Request

- Base URL: `https://api.elevenlabs.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.elevenlabs.io/v1/pronunciation-dictionaries/{pronunciation_dictionary_id}`
- Auth: none declared

Get metadata for a pronunciation dictionary

## Path parameters

- `pronunciation_dictionary_id` string, required: The id of the pronunciation dictionary

## Headers

- `xi-api-key` string, nullable: Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Response `200`

Successful Response

- GetPronunciationDictionaryWithRulesResponseModel
  - `id` string, required: The ID of the pronunciation dictionary.
  - `latest_version_id` string, required: The ID of the latest version of the pronunciation dictionary.
  - `latest_version_rules_num` integer, required: The number of rules in the latest version of the pronunciation dictionary.
  - `name` string, required: The name of the pronunciation dictionary.
  - `permission_on_resource` 'admin' | 'editor' | 'commenter' | 'viewer', nullable, required: The permission on the resource of the pronunciation dictionary.
  - `created_by` string, required: The user ID of the creator of the pronunciation dictionary.
  - `creation_time_unix` integer, required: The creation time of the pronunciation dictionary in Unix timestamp.
  - `archived_time_unix` integer, nullable: The archive time of the pronunciation dictionary in Unix timestamp.
  - `description` string, nullable: The description of the pronunciation dictionary.
  - `rules` union[], required: The rules in the latest version of the pronunciation dictionary.
    - union
      - PronunciationDictionaryAliasRuleResponseModel
        - `string_to_replace` string, required
        - `case_sensitive` boolean: Whether the rule matches case-sensitively.
        - `word_boundaries` boolean: Whether the rule only matches at word boundaries.
        - `type` 'alias', required
        - `alias` string, required
      - PronunciationDictionaryPhonemeRuleResponseModel
        - `string_to_replace` string, required
        - `case_sensitive` boolean: Whether the rule matches case-sensitively.
        - `word_boundaries` boolean: Whether the rule only matches at word boundaries.
        - `type` 'phoneme', required
        - `phoneme` string, required
        - `alphabet` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-04-03** `deb5e58ddddf`: 1 info
  - added the required property `rules` to the response with the `200` status
- **2026-02-08** `5b595807512c`: 1 breaking, 1 info
  - api path removed without deprecation
  - endpoint added
- **2025-05-16** `503db4198a44`: 1 breaking, 5 info
  - response property `description` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - `header` request parameter `xi-api-key` list-of-types was widened by adding types `null`
  - for the `header` request parameter `xi-api-key`, the type was generalized from `string` to no type
  - added the required property `archived_time_unix` to the response with the `200` status
  - …2 more
- **2024-05-07** `c1dd2ce19be9`: 1 info
  - added the required property `latest_version_id` to the response with the `200` status
- **2023-11-25** `659035dd9081`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/pronunciation-dictionaries/:pronunciation_dictionary_id/get.md)

---

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