GET
/
api
/
v2
/
voice-clones
List Voice Clones
curl --request GET \
  --url https://api.buena.ai/api/v2/voice-clones \
  --header 'Authorization: <authorization>' \
  --header 'x-api-key: <api-key>'
{
  "success": true,
  "data": {
    "voiceClones": [
      {
        "voiceId": "pNInz6obpgDQGcFmaJgB",
        "name": "Professional Voice",
        "description": "Professional outreach voice for LinkedIn",
        "createdAt": "2024-01-15T10:30:00.000Z",
        "updatedAt": "2024-01-19T14:30:00.000Z",
        "isActive": true,
        "sampleCount": 3,
        "labels": {
          "userId": "user123",
          "createdAt": "2024-01-15T10:30:00.000Z"
        }
      },
      {
        "voiceId": "2EiwWnXFnvU5JabPnv8n",
        "name": "Sales Voice",
        "description": "Energetic sales voice for cold outreach",
        "createdAt": "2024-01-20T08:15:00.000Z",
        "updatedAt": "2024-01-20T08:15:00.000Z",
        "isActive": true,
        "sampleCount": 2,
        "labels": {
          "userId": "user123",
          "createdAt": "2024-01-20T08:15:00.000Z"
        }
      }
    ],
    "total": 2
  }
}

Retrieve a list of all voice clones associated with your account, including their training status, settings, and usage statistics.

Requires the voice:read permission.

​
Request

​
Authorization
string
required

Bearer token with your API key that has voice:read permission (e.g., “Bearer bna-your-api-key”)

​
Query Parameters

​
status
string

Filter by training status: processing, ready, failed

​
limit
number
default:"50"

Number of voice clones to return (1-100)

​
offset
number
default:"0"

Pagination offset

​
Examples

curl -X GET "https://api.buena.ai/api/v2/voice-clones" \
  -H "Authorization: Bearer bna-your-api-key"

​
Response

​
success
boolean

Always true for successful requests

​
data
object

Voice clones data object

{
  "success": true,
  "data": {
    "voiceClones": [
      {
        "voiceId": "pNInz6obpgDQGcFmaJgB",
        "name": "Professional Voice",
        "description": "Professional outreach voice for LinkedIn",
        "createdAt": "2024-01-15T10:30:00.000Z",
        "updatedAt": "2024-01-19T14:30:00.000Z",
        "isActive": true,
        "sampleCount": 3,
        "labels": {
          "userId": "user123",
          "createdAt": "2024-01-15T10:30:00.000Z"
        }
      },
      {
        "voiceId": "2EiwWnXFnvU5JabPnv8n",
        "name": "Sales Voice",
        "description": "Energetic sales voice for cold outreach",
        "createdAt": "2024-01-20T08:15:00.000Z",
        "updatedAt": "2024-01-20T08:15:00.000Z",
        "isActive": true,
        "sampleCount": 2,
        "labels": {
          "userId": "user123",
          "createdAt": "2024-01-20T08:15:00.000Z"
        }
      }
    ],
    "total": 2
  }
}

​
Next Steps

Create Voice Clone

Create a new voice clone

Generate Preview

Test your voice clone

Update Settings

Modify voice clone settings

Delete Voice Clone

Remove a voice clone