list sessions

Returns a list of all sessions for the organization

GET /v1/sessions

list sessions

cURL

curl --request GET \
  --url https://api.anam.ai/v1/sessions \
  --header 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "personaId": null,
      "clientLabel": "anam-lab-chat",
      "startTime": "2026-04-20T09:00:00.000Z",
      "endTime": "2026-04-20T09:12:34.000Z",
      "sessionLengthMs": 754000,
      "exitStatus": "CLOSED_BY_ENGINE",
      "engineHost": "connect-eu.anam.ai/v1/webrtc/engines/anam-engine-7dddcb9ccd-db8v9",
      "engineProtocol": "https",
      "engineVersion": "v5.1.0",
      "clientMetadata": {
        "userAgent": "Mozilla/5.0"
      },
      "personaConfig": {
        "type": "ephemeral",
        "name": "Cara",
        "metadata": {
          "client": "js-sdk"
        },
        "llmConfig": {
          "id": "a7cf662c-2ace-4de1-a21e-ef0fbf144bb7",
          "modelName": "gpt-4o",
          "format": "openai",
          "urls": [
            {
              "url": "https://api.openai.com/v1",
              "region": "default"
            }
          ],
          "maxTokens": 4096,
          "temperature": 0.7,
          "metadata": {},
          "secret_iv": "[REDACTED]",
          "encrypted_secret": "[REDACTED]",
          "createdByOrganizationId": null
        },
        "systemPrompt": "You are a helpful assistant.",
        "personality": "",
        "languageCode": "en",
        "skipGreeting": false,
        "zeroDataRetention": false,
        "ttsProvider": "ELEVENLABS",
        "ttsProviderVoiceId": "lcMyyd2HUfFzxdCaC4Ta",
        "ttsProviderModelId": "eleven_flash_v2_5",
        "ttsProviderOptions": {},
        "avatarEngineKey": "cara_home",
        "avatarVersion": "cara-3",
        "disableBrains": false,
        "fillerPhrases": [],
        "useFillerPhrases": false,
        "enableAudioPassthrough": false,
        "voiceDetectionOptions": {},
        "voiceGenerationOptions": {},
        "maxSessionLengthSeconds": 1000000,
        "fps": 25
      },
      "apiKeyId": "00000000-0000-0000-0000-000000000000",
      "organizationId": "00000000-0000-0000-0000-000000000000",
      "createdAt": "2026-04-20T09:00:00.000Z",
      "updatedAt": "2026-04-20T09:12:34.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 (max 100)

Required range: 1 <= x <= 100

search · string

Search term to filter sessions by ID or client label

apiKeyId · string<uuid>

Filter sessions by API key ID

personaId · string<uuid>

Filter sessions by persona ID

Response

200

application/json

Successfully retrieved sessions

data · object[]

Show child attributes

meta · object

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

Show child attributes