# List Voices

This section explains how to use the `/voices` endpoint to get phone number data using TalkStack's API.

**Step1: Prepare Your Request**

* **Endpoint:** `/voices`
* **Method:** `GET`
* **URL:** `https://api.talkstackai.com/voices`
* **Headers:** Include `Content-Type: application/json`.
* **Authorization:** Bearer token or x-api-key in Headers

**Step 2: Send the Request**

Use your preferred HTTP client to send the GET request.

**Step 3: Handle the request**

The response will provide a detailed list of voices.

**Success Response:**

* **Status Code:** `200 OK`
* **Body:**

```json
{
    "message": "successfully fetched voice list.",
    "status": "success",
    "voices": [
        {
            "name": "Aria",
            "labels": {
                "accent": "American",
                "description": "expressive",
                "age": "middle-aged",
                "gender": "female",
                "use_case": "social media"
            },
            "voice_id": "XXXXXXXXXXXXXXXX",
            "preview_url": "XXXXXXXXXXXXXXXXXXXXX"
        },
        {
            "name": "Roger",
            "labels": {
                "accent": "American",
                "description": "confident",
                "age": "middle-aged",
                "gender": "male",
                "use_case": "social media"
            },
            "voice_id": "XXXXXXXXXXXXXXXXXXX",
            "preview_url": "XXXXXXXXXXXXXXXXXXXXXXXXXXX"
        },
        ...
    ]
}
```

**Troubleshooting**

* `401 Unauthorized`: If the user is unauthorized or the token is missing.
* `500 Internal Server Error`: For errors in getting voices list.