---
title: "Cloned Voices - List user's cloned voices"
method: GET
path: "/v1/cloned-voices"
tags: ["cloned-voices"]
---

# Cloned Voices - List user's cloned voices

`GET /v1/cloned-voices`

## Request

- Base URL: `https://api.magnific.com`
- URL: `https://api.magnific.com/v1/cloned-voices`
- Auth: API key in header `x-magnific-api-key`

Retrieve all cloned voices belonging to the authenticated user.

Returns completed cloned voices created via the ElevenLabs voice cloning feature.
Each voice includes metadata such as name, gender, language, provider, and preview audio URL.

**Enterprise only** — this endpoint is available exclusively for Enterprise API key plans.

## Response `200`

List of cloned voices

- ListClonedVoices200Response
  - `data` ListClonedVoices200ResponseDataInner[]
    - `id` integer: Unique voice identifier
    - `name` string: User-defined voice name
    - `description` string, nullable: Optional voice description
    - `preview_image_url` string, nullable: URL of the voice's preview image
    - `example_mp3_url` string, nullable: URL of a sample audio clip
    - `gender` string, nullable: Voice gender
    - `accent_id` string, nullable: Accent identifier
    - `provider` string: Voice provider
    - `eleven_labs_voice` string: Provider-specific voice ID
    - `main_languages` ListClonedVoices200ResponseDataInnerMainLanguagesInner[]
      - `id` integer
      - `identifier` string
      - `name` string
    - `is_cloned` boolean
    - `is_active` boolean
    - `status` string: Voice cloning status
    - `last_used_at` string, date-time, nullable: ISO 8601 timestamp of last usage
    - `deleted_at` string, date-time, nullable: ISO 8601 timestamp if soft-deleted

## Other responses

- `401`: Unauthorized - The client must authenticate itself to get the requested response.
- `403`: Forbidden - The client does not have permission to access the requested resource.
- `500`: Internal Server Error - The server has encountered a situation it doesn't know how to handle.
- `503`: Service Unavailable

---

[API](https://skmtc.dev/magnific/apis/magnific-api.md) · [All operations](https://skmtc.dev/magnific/apis/magnific-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magnific/apis/magnific-api/revisions/60711fb082c7?raw)