Skip to main content
GET
/
v1
/
sessions
list sessions
curl --request GET \
  --url https://api.anam.ai/v1/sessions \
  --header 'Authorization: Bearer <token>'
{
  "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 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

Successfully retrieved sessions

data
object[]
meta
object

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

Last modified on April 22, 2026