Returns detailed information about a Suno persona, including its clips, metadata, and ownership status. Results are paginated.
Request
Query parameters
The ID of the persona to retrieve. Returns 400 if missing.
Page number for paginating through the persona’s clips. Defaults to 1.
Response
A persona info object.
The persona data object.
Unique identifier for the persona.
Display name of the persona.
Description of the persona.
S3 image identifier for the persona’s avatar.
ID of the persona’s root/seed clip.
persona.user_display_name
Display name of the user who owns the persona.
Handle (username) of the persona owner.
URL of the persona owner’s profile image.
Whether this is an official Suno persona.
Whether the persona has been deleted.
Whether the authenticated user owns this persona.
Whether the persona is publicly visible.
persona.is_public_approved
Whether the persona has been approved for public listing.
Whether the authenticated user has liked this persona.
Total number of upvotes the persona has received.
Total number of clips associated with the persona.
Array of clip objects associated with this persona on the current page.
Total number of clips associated with the persona across all pages.
The current page number returned.
Whether the authenticated user is following this persona.
Error responses
| Status | Meaning |
|---|
400 | id parameter is missing |
500 | Internal server error |
Examples
Request
curl "http://localhost:3000/api/persona?id=abc123&page=1"
Response
{
"persona": {
"id": "abc123",
"name": "RockLegend",
"description": "A persona specializing in classic rock styles.",
"image_s3_id": "persona_images/abc123.jpg",
"root_clip_id": "clip-xyz-001",
"user_display_name": "Jane Smith",
"user_handle": "janesmith",
"user_image_url": "https://cdn1.suno.ai/avatars/janesmith.jpg",
"is_suno_persona": false,
"is_trashed": false,
"is_owned": false,
"is_public": true,
"is_public_approved": true,
"is_loved": false,
"upvote_count": 142,
"clip_count": 27,
"persona_clips": []
},
"total_results": 27,
"current_page": 1,
"is_following": false
}
