Skip to main content
GET
/
v1
/
personas
list personas
curl --request GET \
  --url https://api.anam.ai/v1/personas \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "name": "Cara",
      "description": "A helpful assistant",
      "personaPreset": "",
      "avatar": {
        "id": "071b0286-4cce-4808-bee2-e642f1062de3",
        "displayName": "Liv",
        "variantName": "home",
        "imageUrl": "https://lab.anam.ai/persona_thumbnails/liv_home.png",
        "videoUrl": "https://anam-prod.r2.cloudflarestorage.com/avatars/v2/stock/liv_home/idling_video.mp4?X-Amz-Signature=...",
        "createdAt": "2026-04-20T10:00:00.000Z",
        "updatedAt": "2026-04-20T10:00:00.000Z",
        "createdByOrganizationId": null,
        "availableVersions": [
          "v1",
          "v2",
          "cara-4-3"
        ],
        "activeVersion": "v2"
      },
      "voice": {
        "id": "de23e340-1416-4dd8-977d-065a7ca11697",
        "displayName": "Lucy - Fresh & Casual",
        "provider": "ELEVENLABS",
        "providerVoiceId": "lcMyyd2HUfFzxdCaC4Ta",
        "providerModelId": "eleven_flash_v2_5",
        "sampleUrl": "https://newgxnc1uqs0jnqm.public.blob.vercel-storage.com/voice-samples/de23e340-1416-4dd8-977d-065a7ca11697/1760617899390.mp3",
        "previewSampleUrl": "https://newgxnc1uqs0jnqm.public.blob.vercel-storage.com/voice-samples/de23e340-1416-4dd8-977d-065a7ca11697/1760617899390.mp3",
        "gender": "FEMALE",
        "country": "GB",
        "description": "Energetic and youthful British voice, perfect for narrations and conversational agents.",
        "displayTags": [
          "fast"
        ],
        "isZdr": true,
        "createdByOrganizationId": null,
        "createdAt": "2026-04-20T10:00:00.000Z",
        "updatedAt": "2026-04-20T10:00:00.000Z"
      },
      "voiceSpeed": 1,
      "isDefaultPersona": false,
      "languageCode": "inherit",
      "createdAt": "2026-04-20T10:00:00.000Z",
      "updatedAt": "2026-04-20T10:00:00.000Z"
    }
  ],
  "meta": {
    "total": 1,
    "lastPage": 1,
    "currentPage": 1,
    "perPage": 10,
    "prev": null,
    "next": null
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

page
integer
default:1

Page number for pagination

Required range: x >= 1
perPage
integer
default:10

Number of items per page

Required range: 1 <= x <= 100

filter personas by name

Response

Successfully retrieved personas

data
object[]
meta
object

Pagination metadata returned alongside the data array of every list endpoint.

Last modified on April 22, 2026