# List voices (library or your clones)

> GET /voices. HeyRik API parameters and documented request and response examples.

Source: https://www.heyrik.com/docs/api-reference/voices/get-voices-list-voices-library-or-your-clones

GET https://server.heyrik.com/api/v1/voices

## Headers

Authorization: Bearer $HEYRIK_API_KEY (required). Keep your key on your server.

## Parameters

- type (string): "all" (library voices, default) or "cloned" (only voices YOU cloned).
- language (string): Filter, e.g. en-IN, hi-IN.
- gender (string): male | female.
- page (number): Page number; walk with has_more.
- limit (number): Page size (default 24, max 100).

## Notes

Copy a voice `id` (starts with vx_) into voice_settings.voice_id on POST/PATCH /agents. Cloned voices are private to your account.

## Request example

```sh
# Library voices
curl "https://server.heyrik.com/api/v1/voices?language=en-IN" \
  -H "Authorization: Bearer $HEYRIK_API_KEY"

# Only your cloned voices
curl "https://server.heyrik.com/api/v1/voices?type=cloned" \
  -H "Authorization: Bearer $HEYRIK_API_KEY"
```

## Response example

```json
{
  "data": {
    "count": 42,
    "page": 1,
    "has_more": true,
    "voices": [
      {
        "id": "vx_9f2a1c30",
        "name": "Meera",
        "language": "en-IN",
        "gender": "female",
        "cloned": false
      }
    ]
  }
}
```