---
title: "List Voices"
method: GET
path: "/v2/voices"
tags: ["Voices"]
---

# List Voices

`GET /v2/voices`

Returns available stock **`voice_name`** values and their linked **face** metadata. When you [Create Face](/api-reference/faces/create-face) with **`train_image_url`** (image-to-face), **`voice_name`** is required-use this list to pick a valid slug and to preview options.

## Query parameters

- `limit` integer
- `page` integer
- `search` string
- `sort` 'asc' | 'desc'
- `tag` string

## Response `200`

- object
  - `data` object[] — Voices for the current page; use `total_count`, `page`, and `limit` with the query parameters for pagination.
    - `voice_name` string — Slug to pass as **`voice_name`** on Create Face (image-to-face).
    - `face_id` string — face identifier associated with this voice.
    - `audio_url` string, nullable — Optional preview URL (e.g. sample clip) when available.
    - `tags` object[] — Tags from the face record (e.g. for filtering).
      - `tag_name` string
  - `total_count` integer — Total rows matching filters (before pagination).
  - `page` integer
  - `limit` integer

## Other responses

- `401` — UNAUTHORIZED

---

[API](https://skmtc.net/tavus/apis/tavus-developer-api-collection.md) · [All operations](https://skmtc.net/tavus/apis/tavus-developer-api-collection/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tavus/tavus-developer-api-collection/versions/c878e2f6508d/schema)