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

# list pronunciation dictionaries

`GET /v1/pronunciation-dictionaries`

## Request

- Base URL: `https://api.anam.ai`
- URL: `https://api.anam.ai/v1/pronunciation-dictionaries`
- Auth: HTTP bearer

Lists your organization's pronunciation dictionaries, newest first. Archived dictionaries are not listed. Entries are omitted; read a dictionary to get them.

## Query parameters

- `page` integer
- `perPage` integer

## Response `200`

Successfully retrieved pronunciation dictionaries

- object
  - `data` PronunciationDictionarySummary[]
    - `id` string, uuid: Pronunciation dictionary ID. Pass it as `voiceGenerationOptions.pronunciationDictionaryId` when creating a session token.
    - `name` string: Display name
    - `revision` integer: Starts at 1 and increases with every save. Send it as `expectedRevision` to reject a write if someone else saved first.
    - `createdAt` string, date-time: When the dictionary was created
    - `updatedAt` string, date-time: When the dictionary was last saved
  - `meta` Pagination: Pagination metadata returned alongside the `data` array of every list endpoint.
    - `total` integer: Total number of items across all pages.
    - `lastPage` integer: Number of the last page.
    - `currentPage` integer: Number of the current page.
    - `perPage` integer: Number of items per page.
    - `prev` integer, nullable: Number of the previous page, or null if on the first page.
    - `next` integer, nullable: Number of the next page, or null if on the last page.

## Other responses

- `400`: Bad request - Invalid pagination parameters
- `401`: Unauthorized - Invalid or missing API key
- `403`: Forbidden - API key lacks read access to pronunciation dictionaries
- `500`: Server error
- `503`: The API key could not be checked because of a temporary server problem. The key may be valid; retry after `Retry-After` seconds.

## Changes

- **2026-10-26** `e85ef0cd491e`: 1 info
  - added the non-success response with the status `503`
- **2026-10-14** `5ae8f3dbfe52`: 1 info
  - endpoint added

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

---

[API](https://skmtc.dev/anam/apis/anam-ai-api.md) - [All operations](https://skmtc.dev/anam/apis/anam-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/anam/apis/anam-ai-api/revisions/3e535ea89083?raw)
