Skip to main content
GET
https://app.voiz.mx/api/
/
user
/
assistants
/
voices
Get available voices
curl --request GET \
  --url https://app.voiz.mx/api/user/assistants/voices \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": 1,
    "name": "Alloy",
    "language_id": 1,
    "gender": "female"
  },
  {
    "id": 2,
    "name": "Echo",
    "language_id": 1,
    "gender": "male"
  },
  {
    "id": 3,
    "name": "Coral",
    "language_id": null,
    "gender": "female"
  }
]
This endpoint returns a list of all available voices that can be used when creating or updating assistants, with optional filtering by assistant mode and language.

​
Query Parameters

​
mode
string
Filter voices by assistant mode. Options: pipeline, multimodal, dualplex
​
language_id
integer
Filter voices by language ID. Use the Get Languages endpoint to get available language IDs.

​
Response fields

​
data
array
[
  {
    "id": 1,
    "name": "Alloy",
    "language_id": 1,
    "gender": "female"
  },
  {
    "id": 2,
    "name": "Echo",
    "language_id": 1,
    "gender": "male"
  },
  {
    "id": 3,
    "name": "Coral",
    "language_id": null,
    "gender": "female"
  }
]

​
Notes

  • Use the id field as voice_id when creating or updating assistants
  • Filter by mode to get only voices compatible with your intended assistant type
  • Filter by language_id to get voices for a specific language
  • If no filters are provided, all available voices are returned
  • Only voices that are public or belong to the authenticated user are returned