---
title: "List Voices"
method: GET
path: "/voice/voices"
tags: ["Voice Agents"]
---

# List Voices

`GET /voice/voices`

## Request

- Base URL: `https://api.speakai.co/v1`
- URL: `https://api.speakai.co/v1/voice/voices`
- Auth: API key in header `x-speakai-key` and API key in header `x-access-token`

### List Voices

Lists the voices visible to your company: Speak's shared system catalog, plus your own company's uploaded voices, whether public or not.

## Response `200`

OK

- object
  - `status` 'success'
  - `data` object
    - `voices` object[]
      - `_id` string: MongoDB document id, included because every document has one. Not used to identify a voice anywhere in this API -- use voiceId for that.
      - `voiceId` string: Client-supplied on create if you send one, otherwise server-generated. The identifier for this voice everywhere in this API (unlike most resources, this catalog has no separate server-generated UUID).
      - `companyId` string, nullable: Absent on a shared system-catalog voice, which every company can read but only Speak can write. Present on a company's own uploaded voice. Not settable directly.
      - `createdBy` string: Id of the user who created this voice. Not settable directly.
      - `name` string: Required on create.
      - `provider` 'elevenlabs' | 'openai' | 'deepgram' | 'cartesia' | 'google' | 'azure': Required on create.
      - `language` string: Defaults to English.
      - `languageCode` string: Defaults to en.
      - `gender` 'male' | 'female' | 'neutral'
      - `age` 'young' | 'middle-aged' | 'old'
      - `accent` string
      - `description` string
      - `previewUrl` string
      - `category` 'premade' | 'cloned' | 'custom' | 'professional' | 'conversational': Defaults to premade.
      - `tags` string[]
      - `isPremium` boolean: Defaults to false.
      - `isMultilingual` boolean: Defaults to false.
      - `isPublic` boolean: Defaults to true.
      - `status` 'active' | 'inactive' | 'processing' | 'error': Defaults to active.
      - `providerData` object: Arbitrary provider-specific data. Shape is not validated.
      - `metadata` object: Arbitrary metadata object. Shape is not validated.
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
    - `total` integer

---

[API](https://skmtc.dev/speakai/apis/speak-ai-api.md) · [All operations](https://skmtc.dev/speakai/apis/speak-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/speakai/apis/speak-ai-api/revisions/52d777e6d46e?raw)