---
title: "Get Pronunciation Dictionaries"
method: GET
path: "/v1/pronunciation-dictionaries"
tags: ["Pronunciation Dictionary"]
---

# Get Pronunciation Dictionaries

`GET /v1/pronunciation-dictionaries`

Get a list of the pronunciation dictionaries you have access to and their metadata

## Query parameters

- `cursor` string, nullable — Used for fetching next page. Cursor is returned in the response.
- `page_size` integer — How many pronunciation dictionaries to return at maximum. Can not exceed 100, defaults to 30.
- `sort` 'creation_time_unix' | 'name', nullable — Which field to sort by, one of 'created_at_unix' or 'name'.
- `sort_direction` string, nullable — Which direction to sort the voices in. 'ascending' or 'descending'.
- `include_archived` boolean — Whether to include archived pronunciation dictionaries in the response.

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

- GetPronunciationDictionariesMetadataResponseModel
  - `pronunciation_dictionaries` GetPronunciationDictionaryMetadataResponseModel[], required — A list of pronunciation dictionaries and their metadata.
    - `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.
  - `next_cursor` string, nullable — The next cursor to use for pagination.
  - `has_more` boolean, required — Whether there are more pronunciation dictionaries to fetch.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elevenlabs/elevenlabs-api-documentation/revisions/e77a0a530a82/schema)