---
title: "List pronunciation dictionaries"
method: GET
path: "/pronunciation_dicts"
tags: ["Pronunciation Dictionaries"]
---

# List pronunciation dictionaries

`GET /pronunciation_dicts`

List all pronunciation dictionaries for the authenticated organization. Results are paginated using offset-based pagination.

## Query parameters

- `page[number]` integer
- `page[size]` integer

## Response `200`

A paginated list of pronunciation dictionaries.

- PronunciationDictListResponse — Paginated list of pronunciation dictionaries.
  - `data` PronunciationDictData[] — Array of pronunciation dictionary objects.
    - `created_at` string, date-time — ISO 8601 timestamp with millisecond precision.
    - `id` string, uuid — Unique identifier for the pronunciation dictionary.
    - `items` PronunciationDictItem[] — List of pronunciation items (alias or phoneme type).
      - union — A single pronunciation dictionary item. Use type 'alias' to replace matched text with a spoken alias, or type 'phoneme' to specify exact pronunciation using IPA notation.
        - PronunciationDictAliasItem — An alias pronunciation item. When the `text` value is found in input, it is replaced with the `alias` before speech synthesis.
          - `alias` string, required — The replacement text that will be spoken instead.
          - `text` string, required — The text to match in the input. Case-insensitive matching is used during synthesis.
          - `type` 'alias', required — The item type.
        - PronunciationDictPhonemeItem — A phoneme pronunciation item. When the `text` value is found in input, it is pronounced using the specified IPA phoneme notation.
          - `alphabet` 'ipa', required — The phonetic alphabet used for the phoneme notation.
          - `phoneme` string, required — The phoneme notation representing the desired pronunciation.
          - `text` string, required — The text to match in the input. Case-insensitive matching is used during synthesis.
          - `type` 'phoneme', required — The item type.
    - `name` string — Human-readable name for the dictionary. Must be unique within the organization.
    - `record_type` 'pronunciation_dict' — Identifies the resource type.
    - `updated_at` string, date-time — ISO 8601 timestamp with millisecond precision.
    - `version` integer — Auto-incrementing version number. Increases by 1 on each update. Used for optimistic concurrency control and cache invalidation.
  - `meta` PronunciationDictsPaginationMeta — Pagination metadata returned with list responses.
    - `page_number` integer — Current page number (1-based).
    - `page_size` integer — Number of results per page.
    - `total_pages` integer — Total number of pages.
    - `total_results` integer — Total number of results across all pages.

## Other responses

- `400` — Invalid pagination parameters.
- `401` — Unauthorized. Invalid or missing API key.

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/1571b0380bd7/schema)