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

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
id
string<uuid>
required

Session ID

Response

Successfully retrieved session

A single connection between a client and a persona. Contains metadata but not the transcript or recording — those are fetched separately.

​
id
string<uuid>

Unique identifier for the session.

​
personaId
string<uuid> | null

ID of the persona the client connected to, or null if the session was issued with an ephemeral persona config.

​
clientLabel
string | null

Label supplied by the caller when minting the session token.

​
startTime
string<date-time>

Timestamp when the session started.

​
endTime
string<date-time> | null

Timestamp when the session ended, or null if still active.

​
sessionLengthMs
integer | null

Duration of the session in milliseconds, or null if still active.

​
exitStatus
string | null

How the session ended (e.g. NORMAL_EXIT, ERROR), or null if still active.

​
engineHost
string | null

Hostname of the engine pod that served the session.

​
engineProtocol
string | null

Protocol used to stream the session (e.g. https).

​
engineVersion
string | null

Version of the engine pod that served the session.

​
clientMetadata
object

Arbitrary metadata collected from the client during the session.

​
personaConfig
object

Snapshot of the persona configuration taken at the moment the session started.

​
apiKeyId
string<uuid> | null

ID of the API key that minted the session token.

​
organizationId
string

ID of the organization that owns the session. IDs may be either UUIDs or nanoid-style strings depending on when the organization was created.

​
createdAt
string<date-time>

Timestamp when the session record was created.

​
updatedAt
string<date-time> | null

Timestamp when the session record was last updated.

Last modified on April 22, 2026