Skip to main content
GET
/
v1
/
voices
List Voices
curl --request GET \
  --url https://api.openmic.ai/v1/voices \
  --header 'Authorization: Bearer <token>'
{
  "voices": [
    {
      "id": 123,
      "name": "<string>",
      "voice_id": "<string>",
      "sample_url": "<string>",
      "provider": "<string>",
      "gender": "<string>",
      "language": "<string>",
      "languages": [
        "<string>"
      ],
      "accent": "<string>",
      "age": "<string>",
      "ethnicity": "<string>",
      "characteristics": [
        "<string>"
      ],
      "description": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "pagination": {
    "limit": 123,
    "offset": 123,
    "total": 123,
    "has_more": true
  },
  "filters": {
    "available_genders": [
      "<string>"
    ],
    "available_providers": [
      "<string>"
    ],
    "available_languages": [
      "<string>"
    ],
    "available_accents": [
      "<string>"
    ]
  }
}

Authorizations

​
Authorization
string
header
required

API key authentication. Include your API key in the Authorization header as: Authorization: Bearer <your-api-key>

Query Parameters

​
limit
integer
default:50

Maximum number of voices to return (1-100).

Required range: 1 <= x <= 100
​
offset
integer
default:0

Number of voices to skip for pagination.

Required range: x >= 0
​
search
string

Search voices by name or description (case-insensitive).

​
gender
string

Filter by gender (e.g. 'male', 'female').

​
provider
string

Filter by TTS provider (e.g. 'elevenlabs', 'deepgram').

​
language
string

Filter by language code (e.g. 'en', 'es').

​
accent
string

Filter by accent (case-insensitive partial match).

​
sort_by
enum<string>

Field to sort results by.

Available options:
name,
created_at
​
sort_order
enum<string>
default:asc

Sort direction.

Available options:
asc,
desc

Response

200 - application/json

Paginated list of voices with available filter values.

​
voices
object[]
​
pagination
object
​
filters
object

Lists of distinct values available for each filter field, useful for building filter UIs.