GET /v1/playlists

Retrieve all of your playlists. Use this to look up playlist IDs for the detail, add, remove, and move endpoints.

Request

GET https://pub.finetuning.ai/v1/playlists

Headers

Header	Type	Required	Description
`X-API-Key`	string	Yes	Your API key

There are no query parameters — all of your playlists are returned in one response.

Example

curl https://pub.finetuning.ai/v1/playlists \
  -H "X-API-Key: ft_live_your_key_here"

Response

200 OK

{
  "data": {
    "playlists": [
      {
        "id": "9b2f51e2-4c1a-4b8e-9d3e-2f7a8c641b05",
        "name": "Focus Beats",
        "description": "Deep work background loops",
        "trackCount": 14,
        "totalDuration": 2520,
        "isPublic": false,
        "createdAt": "2025-01-10 09:00:00",
        "updatedAt": "2025-01-15 10:30:00"
      },
      {
        "id": "3f8c2d10-7e5b-4a92-b6d1-8e4f0a92c7d3",
        "name": "Podcast Intros",
        "description": null,
        "trackCount": 6,
        "totalDuration": 480,
        "isPublic": true,
        "createdAt": "2025-01-12 14:00:00",
        "updatedAt": "2025-01-12 14:00:00"
      }
    ]
  }
}

Response fields

Field	Type	Description
`data.playlists`	array	Array of playlist objects
`data.playlists[].id`	string	Unique playlist ID (UUID)
`data.playlists[].name`	string	Playlist name
`data.playlists[].description`	string \| null	Playlist description
`data.playlists[].trackCount`	number	Number of tracks in the playlist
`data.playlists[].totalDuration`	number	Combined track length in seconds
`data.playlists[].isPublic`	boolean	Whether the playlist is publicly visible
`data.playlists[].createdAt`	string	Creation timestamp
`data.playlists[].updatedAt`	string	Last update timestamp

Errors

Code	Status	Description
`MISSING_API_KEY`	401	X-API-Key header was not provided
`INVALID_API_KEY`	401	API key is malformed, revoked, or does not exist
`INTERNAL_ERROR`	500	Unexpected server error