> ## Documentation Index
> Fetch the complete documentation index at: https://docs.luly.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Voices

> Retrieves all available voices for your account.

### Headers

<ParamField header="authorization" type="string" required={true}>
  Your API key for authentication.
</ParamField>

### Response

<ResponseField name="voices" type="array">
  Contains a list of the voices available for your account.
</ResponseField>

<ResponseField name="voices[].id" type="string">
  The unique identifier for the voice.
</ResponseField>

<ResponseField name="voices[].name" type="string">
  The name of the voice. This value can also be used in the voice parameter when sending calls.
</ResponseField>

<ResponseField name="voices[].description" type="string">
  A brief description of the voice.
</ResponseField>

<ResponseField name="voices[].public" type="boolean">
  Indicates whether the voice is publicly available or specific to your account.
</ResponseField>

<ResponseField name="voices[].tags" type="array">
  A list of tags that describe the voice. We recommend “Luly Curated” voices for the best quality over the phone.
</ResponseField>

<ResponseField name="voices[].total_ratings" type="number">
  The number of ratings the voice has received.
</ResponseField>

<ResponseField name="voices[].average_rating" type="number">
  The average rating of the voice, out of 5.
</ResponseField>

Note: Ratings are under development at this time and may display incomplete/inaccurate data.

<ResponseExample>
  ```json Response
  {
      "voices": [
          {
              "id": "2f9fdbc7-4bf2-4792-8a18-21ce3c93978f",
              "name": "maya",
              "description": "Young American Female",
              "public": true,
              "tags": [
                  "english",
                  "soft",
                  "Luly Curated"
              ]
          },
          {
              "id": "37b3f1c8-a01e-4d70-b251-294733f08371",
              "name": "ryan",
              "description": "Professional American Male",
              "public": true,
              "tags": [
                  "english",
                  "Luly Curated"
              ]
          },
          {
              "id": "90295ec4-f0fe-4783-ab33-8b997ddc3ae4",
              "name": "mason",
              "description": "American Male",
              "public": true,
              "tags": [
                  "english",
                  "Luly Curated"
              ]
          },
          {
              "id": "bbeabae6-ec8d-444f-92ad-c8e620d3de8d",
              "name": "tina",
              "description": "Gentle American Female",
              "public": true,
              "tags": [
                  "english",
                  "gentle"
              ]
          },
          //...
      ]
  }

  ```
</ResponseExample>