> ## Documentation Index
> Fetch the complete documentation index at: https://tryunsora.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List voices

> Browse the 20 ElevenLabs Eleven v3 voices available for Unsora voiceovers, each with a preview clip to help you pick the right one.

Lists the voices available for [Create voiceover](/docs/api-reference/voiceovers/create). Every voice includes a short `previewUrl` audio clip — play it to check which voice fits your script before spending credits.

```bash theme={null}
curl "https://mvp.tryunsora.com/api/v1/voiceovers/voices" \
  -H "Authorization: Bearer uns_live_YOUR_API_KEY"
```

Example response (truncated):

```json theme={null}
{
  "success": true,
  "voices": [
    {
      "id": "Aria",
      "label": "Aria",
      "description": "Expressive, husky female voice for social media and storytelling",
      "gender": "female",
      "accent": "american",
      "previewUrl": "https://<storage>/voice-previews/eleven-v3/Aria.mp3"
    },
    {
      "id": "George",
      "label": "George",
      "description": "Warm, mature male narrator for storytelling",
      "gender": "male",
      "accent": "british",
      "previewUrl": "https://<storage>/voice-previews/eleven-v3/George.mp3"
    }
  ]
}
```

Pass the voice `id` as `voice_id` when creating a voiceover.

## Available voices

| `voice_id`  | Gender  | Accent     | Best for                   |
| ----------- | ------- | ---------- | -------------------------- |
| `Aria`      | female  | american   | Social media, storytelling |
| `Roger`     | male    | american   | Casual conversations       |
| `Sarah`     | female  | american   | Professional narration     |
| `Laura`     | female  | american   | Upbeat social media        |
| `Charlie`   | male    | australian | Energetic content          |
| `George`    | male    | british    | Storytelling, narration    |
| `Callum`    | male    | american   | Characters, intense reads  |
| `River`     | neutral | american   | Neutral narration          |
| `Liam`      | male    | american   | Reels and shorts           |
| `Charlotte` | female  | swedish    | Characters, narration      |
| `Alice`     | female  | british    | E-learning, explainer      |
| `Matilda`   | female  | american   | Educational content        |
| `Will`      | male    | american   | Chill conversational reads |
| `Jessica`   | female  | american   | Trendy, playful content    |
| `Eric`      | male    | american   | Agents, customer support   |
| `Chris`     | male    | american   | Everyday natural reads     |
| `Brian`     | male    | american   | Narrations and ads         |
| `Daniel`    | male    | british    | News, broadcasts           |
| `Lily`      | female  | british    | News, narration            |
| `Bill`      | male    | american   | Storytelling, ads          |


## OpenAPI

````yaml GET /voiceovers/voices
openapi: 3.1.0
info:
  title: Unsora API
  version: 1.2.0
  description: >-
    Public API for Unsora integrations. Use Bearer token from Clerk in
    Authorization header.
servers:
  - url: /api/v1
    description: Versioned API
security: []
tags:
  - name: User
  - name: Connect
  - name: Stripe
  - name: Video
  - name: Image
  - name: Influencer
  - name: Thumbnail
  - name: Clipping
  - name: Music
  - name: Voiceover
  - name: Uploads
paths:
  /voiceovers/voices:
    get:
      tags:
        - Voiceover
      summary: List Eleven v3 voices with preview clips
      description: >-
        Returns the 20 ElevenLabs Eleven v3 voices available for voiceover
        generation. Each voice includes a short previewUrl clip so users can
        pick a voice by ear.
      responses:
        '200':
          description: Voice catalog
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoiceoverVoicesResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    VoiceoverVoicesResponse:
      type: object
      properties:
        success:
          type: boolean
        voices:
          type: array
          items:
            $ref: '#/components/schemas/VoiceoverVoice'
      required:
        - success
        - voices
    VoiceoverVoice:
      type: object
      properties:
        id:
          type: string
          description: voice_id to pass to /voiceovers/create
        label:
          type: string
        description:
          type: string
        gender:
          type: string
          enum:
            - male
            - female
            - neutral
        accent:
          type: string
        previewUrl:
          anyOf:
            - type: string
              format: uri
            - type: 'null'
          description: Short sample clip of the voice
      required:
        - id
        - label
        - description
        - gender
        - accent
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````