---
title: "list voices"
method: GET
path: "/v1/voices"
tags: ["Voices"]
---

# list voices

`GET /v1/voices`

Returns a list of all voices

## Query parameters

- `page` integer
- `perPage` integer
- `search` string

## Response `200`

Successfully retrieved voices

- object
  - `data` Voice[]
    - `id` string, uuid — Unique identifier for the voice.
    - `displayName` string — Human-readable name shown in the Lab.
    - `provider` 'CARTESIA' | 'ELEVENLABS' | 'OPENAI_ADVANCED_VOICE' | 'FISH_AUDIO' — Upstream TTS provider for this voice.
    - `providerVoiceId` string, nullable — The upstream provider's identifier for the voice.
    - `providerModelId` string, nullable — The upstream provider's model identifier used to generate speech.
    - `sampleUrl` string, uri, nullable — URL of a short audio preview of the voice.
    - `previewSampleUrl` string, uri, nullable — Alias for `sampleUrl`, kept for backwards compatibility.
    - `gender` 'MALE' | 'FEMALE' | 'NEUTRAL' | 'null', nullable — Perceived gender of the voice, if categorised.
    - `country` string, nullable — ISO 3166-1 alpha-2 country code representing the voice's accent.
    - `description` string, nullable — Free-form description of the voice's character.
    - `displayTags` string[] — Tags used to categorise the voice in the Lab UI.
    - `isZdr` boolean — Whether this voice meets the Zero Data Retention requirements.
    - `createdByOrganizationId` string, nullable — ID of the organization that created the voice, or `null` for stock voices. IDs may be either UUIDs or nanoid-style strings depending on when the organization was created.
    - `createdAt` string, date-time — Timestamp when the voice was created.
    - `updatedAt` string, date-time — Timestamp when the voice was last updated.
  - `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

- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - Account does not have access or API key lacks the required permission
- `404` — Not Found - No voices found
- `500` — Server error

---

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