Retrieve your reference tracks

December 13, 2024

Table of contents

  1. Request Headers
  2. Query Parameters
  3. Responses
  4. Model
  5. Examples
  6. Try It

Retrieve full list of track uploaded using POST /files. Keep in mind that all uploaded files will be visible to all users of Mureka.ai website.

Use id value to reference a track when using the parameter ref_id of POST /music/create-advanced.

https://api.useapi.net/v1/mureka/files/?…

Request Headers 
Authorization: Bearer {API token}
Content-Type: application/json
Query Parameters

  • account is optional when only one account configured. However, if you have multiple accounts configured, this parameter becomes required.

  • last_id is optional. Use it to retrieve the next page of data. To do so, set its value to the last_id returned in the previous response when the more field in that response is true.

Responses

  • 200 OK

    {
    "list": [
        {
            "id": 1122334455,
            "url": "https://<song download url>.mp3",
            "duration_milliseconds": 30000,
            "mood": "relaxed",
            "title": "<song title>",
            "genre": "afrobeat",
            "username": "<user name>"
        },
        {
            "id": 66778899,
            "url": "https://<song download url>.mp3",
            "duration_milliseconds": 30000,
            "mood": "restless",
            "title": "<song title>",
            "genre": "rock",
            "username": "<user name>"
        }
    ],
    "last_id": 77665544332211,
    "more": true
}

  • 400 Bad Request

    {
    "error": "<Error message>",
    "code": 400
}

  • 401 Unauthorized

    {
  "error": "Unauthorized",
  "code": 401
}

  • 596 Account Error

    Returned when the account has an error state preventing API calls.

    {
    "error": "Session refresh failed 2026-01-19T14:31:15.000Z, manual update required",
    "code": "REFRESH_FAILED"
}

    Possible error codes:

    • ACCOUNT_ERROR - Account has a blocking error
    • REFRESH_FAILED - Automatic token refresh failed
    • REFRESH_IN_PROGRESS - Token refresh already in progress, retry shortly
    • SESSION_EXPIRED - Session expired and no auto-refresh available
    • COOKIE_EXPIRED - Google cookie has expired

    To resolve, update your account configuration via POST /accounts.

Model 
{ // TypeScript, all fields are optional
    list: {
        id: number
        url: string
        duration_milliseconds: number
        mood: string
        title: string
        genre: string
        username: string
    }[]
    last_id: number
    more: boolean
}
Examples 
  • curl "https://api.useapi.net/v1/mureka/files/?account=account" \
   -H "Accept: application/json" \
   -H "Authorization: Bearer …" 

  • const token = "API token";
const account = "Previously configured account"; 
const apiUrl = `https://api.useapi.net/v1/mureka/files/?account=${account}`; 
const response = await fetch(apiUrl, {
  headers: {
    "Authorization": `Bearer ${token}`,
  },
});
const result = await response.json();
console.log("response", {response, result});

  • import requests
token = "API token"
account = "Previously configured account"
apiUrl = f"https://api.useapi.net/v1/mureka/files/?account={account}"
headers = {
    "Content-Type": "application/json", 
    "Authorization" : f"Bearer {token}"
}
response = requests.get(apiUrl, headers=headers)
print(response, response.json())
Try It