GET /v1/songs/uploads
Your uploads that haven't been deleted yet
List your song uploads that are still inside their 24 hours, newest first. Deleted uploads aren't listed, but you can still fetch one by id with GET /v1/songs/uploads/:id.
Request
GET https://pub.finetuning.ai/v1/songs/uploadsHeaders
| Header | Type | Required | Description |
|---|---|---|---|
X-API-Key | string | Yes | Your API key |
Query parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
limit | number | 20 | 1–99 |
offset | number | 0 | For the next page, pass the previous response's nextOffset |
Example request
curl "https://pub.finetuning.ai/v1/songs/uploads?limit=10" \
-H "X-API-Key: ft_live_your_key_here"const res = await fetch('https://pub.finetuning.ai/v1/songs/uploads?limit=10', {
headers: { 'X-API-Key': process.env.FINETUNING_API_KEY! },
})
const { data } = await res.json()Response
{
"data": {
"uploads": [
{
"id": "22970e5b-c403-494c-b10d-846df6dde7c5",
"feature": "reimagine",
"name": "my-song",
"status": "transcribed",
"durationSeconds": 180,
"expiresAt": "2026-10-01T13:53:20.151Z",
"generations": []
}
],
"hasMore": false,
"nextOffset": null
}
}Each item is a full upload object (shortened above), except that generations is always [] here — fetch one upload to see what was made from it.