SMAO API Documentation
Public APIVoices

List selectable voices

Returns the voices the authenticated instance can assign to a new assistant or select during a voice change. Legacy voices retained by existing assistants and voices reserved for internally managed lines are not returned.

GET
/voices
AuthorizationBearer <token>

API key in the Authorization: Bearer <key> header. Keys are created in the SMAO dashboard (Settings → API Keys).

In: header

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.smao.ai/api/v1/voices"
{
  "data": [
    {
      "id": "1887",
      "name": "Celine Weber",
      "languages": [
        "de"
      ],
      "gender": "female",
      "version": "v2"
    }
  ]
}
{
  "error": {
    "code": "unauthorized",
    "message": "Missing API key"
  }
}
{
  "error": {
    "code": "subscription_required",
    "message": "This feature is not available in your current subscription. Please upgrade to a higher plan"
  }
}
{
  "error": {
    "code": "forbidden",
    "message": "No permission"
  }
}
{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded"
  }
}
{
  "error": {
    "code": "internal_error",
    "message": "An unexpected error occurred."
  }
}