Sign in

v4

OpenAPI 3.1.02026-07-313621,3961.8 MB
music-finetunes

Get Music Finetunes

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

get/v1/music/finetunes

Query parameters

cursorstring nullable

Used for fetching the next page. Cursor is returned in the response.

Used for fetching the next page. Cursor is returned in the response.

page_sizeinteger

How many finetunes to return. Max 100, default 50.

How many finetunes to return. Max 100, default 50.

visibility'private' | 'workspace' | 'public'

Filter by visibility. 'private' returns private finetunes; 'workspace' returns workspace-shared finetunes; 'public' returns public finetunes, which are currently ElevenLabs curated finetunes. Omit to return all accessible finetunes.

created_by'self' | 'workspace' | 'elevenlabs'

Filter by creator. 'self' returns finetunes you created; 'workspace' returns finetunes created by workspace teammates; 'elevenlabs' returns ElevenLabs curated finetunes. Omit to return finetunes from all creators.

sort'created_at' | 'name'

Sort by field (created_at or name)

Sort by field (created_at or name)

sort_direction'asc' | 'desc'

Sort direction (asc or desc)

Sort direction (asc or desc)

Headers

xi-api-keystring 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.

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

Successful Response

next_cursorstring nullable required

Cursor to pass as cursor to fetch the next page; null when there are no more results.

has_moreboolean required

Whether more finetunes are available beyond this page.

Example response

{
  "finetunes": [
    {
      "model_id": "music_v1"
    }
  ]
}