---
title: "List Voices"
method: GET
path: "/v1/tts/lyra/voices"
tags: ["Voice AI Beta — Lyra"]
---

# List Voices

`GET /v1/tts/lyra/voices`

Browse the Lyra voice catalog (cached 1 h server-side). Use an item's `id` as `voice_id` when creating a task.

The response is relayed **verbatim** from the upstream catalog — the exact field set is not part of the GenAIPro API contract and may change. Each voice's `preview_url` is an internal proxy path (`/v1/tts/lyra/voices/sample/{id}`): prepend the API base URL to fetch the preview audio. A few voices have no preview sample upstream — for those `preview_url` is an empty string. Lyra voices have no cover images.
> **Rate limit:** 60 requests/minute

## Query parameters

- `limit` integer
- `starting_after` string
- `q` string
- `gender` string
- `language` string
- `is_starred` boolean
- `expand[]` string

## Response `200`

Voice catalog page (upstream-verbatim)

- object

## Other responses

- `429` — Rate limit exceeded
- `502` — Upstream catalog error — retry later

## Changes

- **2026-09-16** `c2782cee0caa` — 4 info
  - added the optional property `code` to the response with the `429` status
  - added the optional property `limit` to the response with the `429` status
  - added the optional property `retry_after` to the response with the `429` status
  - added the optional property `window_seconds` to the response with the `429` status

[Change history](https://skmtc.dev/genaipro/apis/genaipro-api/changes/v1/tts/lyra/voices/get.md)

---

[API](https://skmtc.dev/genaipro/apis/genaipro-api.md) · [All operations](https://skmtc.dev/genaipro/apis/genaipro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/genaipro/apis/genaipro-api/revisions/871974b052db?raw)