---
title: "Get Music Finetunes"
method: GET
path: "/v1/music/finetunes"
tags: ["music-finetunes"]
---

# Get Music Finetunes

`GET /v1/music/finetunes`

List music finetunes accessible to you (your own, workspace-shared, and ElevenLabs-curated), with optional filtering, sorting, and cursor pagination.

## Query parameters

- `cursor` string, nullable — Used for fetching the next page. Cursor is returned in the response.
- `page_size` integer — How many finetunes to return. Max 100, default 50.
- `visibility` 'private' | 'workspace' | 'public'
- `created_by` 'self' | 'workspace' | 'elevenlabs'
- `sort` 'created_at' | 'name' — Sort by field (created_at or name)
- `sort_direction` 'asc' | 'desc' — Sort direction (asc or desc)

## Headers

- `xi-api-key` string, nullable — Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Response `200`

Successful Response

- MusicFinetunePageResponseModel
  - `finetunes` MusicFinetuneResponseModel[], required — The finetunes in this page.
    - `id` string, required — Unique identifier of the finetune.
    - `name` string, required — Name of the finetune.
    - `tags` string[], required — Tags associated with the finetune.
    - `primary_genre` string, nullable — Primary musical genre of the finetune.
    - `model_id` string, required — The base music model the finetune was trained on.
    - `created_at` string, date-time, required — When the finetune was created (UTC).
    - `visibility` 'private' | 'workspace' | 'public', required
    - `created_by` 'self' | 'workspace' | 'elevenlabs', required
    - `status` 'pending' | 'in_progress' | 'completed' | 'failed' | 'blocked', required
    - `training_progress` number, required — Training progress from 0.0 to 1.0.
    - `failure_reason` 'audio_processing_failed' | 'copyright_violation' | 'training_failed'
  - `next_cursor` string, nullable, required — Cursor to pass as `cursor` to fetch the next page; `null` when there are no more results.
  - `has_more` boolean, required — Whether more finetunes are available beyond this page.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation.md) · [All operations](https://skmtc.net/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elevenlabs/elevenlabs-api-documentation/revisions/d1075d6a6487/schema)