---
title: "GET /pronunciation-dicts/"
method: GET
path: "/pronunciation-dicts/"
tags: ["PronunciationDicts"]
---

# GET /pronunciation-dicts/

`GET /pronunciation-dicts/`

List all pronunciation dictionaries for the authenticated user

## Query parameters

- `limit` integer, nullable
- `starting_after` string, nullable
- `ending_before` string, nullable

## Headers

- `Cartesia-Version` '2026-03-01', date, required

## Response `200`

- PaginatedPronunciationDicts — Paginated list of pronunciation dictionaries
  - `data` PronunciationDict[], required — List of pronunciation dictionary objects
    - `id` string, required — Unique identifier for the pronunciation dictionary
    - `name` string, required — Name of the pronunciation dictionary
    - `description` string, required — Description of the pronunciation dictionary
    - `is_owner` boolean, required — Whether your organization owns the pronunciation dictionary.
    - `access` object, required — Who can access the pronunciation dictionary
      - `type` 'private' | 'public', required — Who can use the pronunciation dictionary: - `private`: only your organization can use the dictionary - `public`: anyone can use the dictionary
      - `visibility` 'owner' | 'all', required — Who sees the pronunciation dictionary when using the [list endpoint](/api-reference/pronunciation-dicts/list): - `owner`: only your organization sees the dictionary listed - `all`: all users see the dictionary listed
    - `pinned` boolean, required — Whether this dictionary is pinned for the user
    - `items` PronunciationDictItem[], required — List of text-to-pronunciation mappings
      - `text` string, required — The original text to be replaced
      - `pronunciation` string, required — A phonetic representation or text to be said in place of the original text
      - `alias` string — Deprecated. Use `pronunciation` instead. This field is accepted in requests and may be returned for backwards compatibility.
    - `created_at` string, required — ISO 8601 timestamp of when the dictionary was created
    - `owner_id` string, required — ID of the user who owns this dictionary. Use `is_owner` instead.
  - `has_more` boolean, required — Whether there are more dictionaries available
  - `next_page` string, nullable — An ID that can be passed as `starting_after` or `ending_before` to get the next page of data.

---

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