Get Voice data

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

Step1: Prepare Your Request

• Endpoint: /voices/:voice_id

• Method: GET

• URL: https://api.talkstackai.com/voices/:voice_id

• 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 details of voice using voice_id.

Success Response:

• Status Code: 200 OK

• Body:

{
    "message": "successfully fetched voice list.",
    "status": "success",
    "voice": {
        "name": "Aria",
        "labels": {
            "accent": "American",
            "description": "expressive",
            "age": "middle-aged",
            "gender": "female",
            "use_case": "social media"
        },
        "voice_id": "xxxxxxxxxxxxxxxxxxxx",
        "preview_url": "xxxxxxxxxxxxxxxxxxxxxxxxx"
    }
}

Troubleshooting

• 401 Unauthorized: If the user is unauthorized or the token is missing.

• 500 Internal Server Error: For errors in getting voices list.