Skip to main content
GET
Retrieve a session

Authorizations

Authorization
string
header
required

Your AssemblyAI API key in the Authorization header. The raw key works directly; a Bearer prefix is also accepted.

Path Parameters

session_id
string
required

The session's unique ID.

Example:

"sess_9a648a2ab75747a9a597ba046ced3e13"

Response

The session record with artifacts.

id
string
required

Unique ID of the session.

Example:

"sess_9a648a2ab75747a9a597ba046ced3e13"

status
string
required

Lifecycle status of the session, e.g. completed.

Example:

"completed"

agent_id
string | null

Agent the session ran with. Null when no stored agent was used.

public_close_reason
string | null

Why the session ended, when known.

Example:

"client_end"

duration_seconds
number | null

Session length in seconds. Null while the session is active.

Example:

42.6

config
object | null

Session configuration captured when the session started.

created_at
string<date-time> | null

When the session was created.

ended_at
string<date-time> | null

When the session ended. Null while the session is active.

artifacts
object[]

Recording, timeline, and metadata produced by the session. Empty until the session completes.