GET music/characters — Mureka API v1

List characters

October 16, 2026

Request Headers
Query Parameters
Responses
Model
Examples
Try It

https://api.useapi.net/v1/mureka/music/characters/?…

List the characters you created with POST /music/characters or on mureka.ai, newest first, 20 per page. Pass a character’s id as character_id to POST /music/create-advanced.

Request Headers

Authorization: Bearer {API token}
Content-Type: application/json

API token is required, see Setup useapi.net for details.

Query Parameters

account is optional when only one account is configured. However, if you have multiple accounts configured, this parameter becomes required.
last_id is optional, the last_id value of the previous page, to get the next page.

Responses

200 OK

list is empty when the account has no characters. A private character has no is_published field.

{
    "list": [
        {
            "id": 166751507709953,
            "name": "Scarlett",
            "bio": "A clear, articulate mid-range female voice.",
            "tags": [
                "Female",
                "Powerful"
            ],
            "avatar": "https://static-cos.mureka.ai/cos-prod/mureka/static/img/<id>.jpg",
            "is_published": true,
            "user_id": 12345678901234,
            "published_at": 1792191715,
            "created_at": 1792191715,
            "user": {
                "id": "12345678901234",
                "user_id": 12345678901234,
                "stage_name": "[email protected]",
                "profile_image": "https://static-cos.mureka.ai/cos-prod/res/image/portrait/2b_default.png"
            },
            "asset_id": 166751507578881,
            "showcase_edit_range": {},
            "song_description": "An intimate mid-tempo acoustic pop song with soft piano and a clear female lead vocal."
        }
    ],
    "last_id": 166751507709953
}

400 Bad Request

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

401 Unauthorized

{
  "error": "Wrong username/password combination.",
  "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

{
    list: {
        id: number                     // character_id for POST /music/create-advanced
        name: string
        bio?: string
        tags?: string[]
        avatar?: string
        is_published?: boolean         // left out when the character is private
        published_at?: number          // Unix seconds
        created_at?: number            // Unix seconds
        song_use_count?: number        // songs made with this character
        vocal_showcase?: string        // preview audio, for characters made on mureka.ai
        song_description?: string
        user_id?: number
        user?: object
        asset_id?: number
        showcase_edit_range?: object
    }[]
    last_id?: number                   // pass as last_id for the next page
}

Examples

curl -H "Accept: application/json" \
     -H "Authorization: Bearer …" \
     "https://api.useapi.net/v1/mureka/music/characters/?account=<account>"

const account = "12345678901234";
const apiUrl = `https://api.useapi.net/v1/mureka/music/characters/?account=${account}`; 
const token = "API token";
const data = { 
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${token}` }
};
const response = await fetch(apiUrl, data);
const result = await response.json();
console.log("response", {response, result});

import requests
account = "12345678901234"
apiUrl = f"https://api.useapi.net/v1/mureka/music/characters/?account={account}" 
token = "API token"
headers = {
    "Authorization" : f"Bearer {token}"
}
response = requests.get(apiUrl, headers=headers)
print(response, response.json())