Skip to main content
GET
Retrieve a paginated list of songs in your workspace, sorted by creation date (newest first by default).

Request

Headers

string
required
Bearer token with your API key

Query Parameters

integer
default:"20"
1–50. Items per page.
integer
default:"0"
0-based offset for pagination.
string
Search over title, prompt, and tags.
string
Filter: generating, ready, or failed.
string
Filter: vocal or instrumental.
string
Filter: true to show only liked songs.
string
default:"newest"
Sort order: newest or oldest.

Response

boolean
True on success
object

Example