Skip to main content
GET
Get session detail

Authorizations

Authorization
string
header
required

API key created in Settings > API.

Format: exec_live_ followed by 40 alphanumeric characters.

Path Parameters

session_id
string
required

The session's unique identifier (UUID)

Query Parameters

include
string

Comma-separated list of optional sections to include in the response. Available values: transcript (conversation lines), evaluations (rubric criteria with grades).

Example:

"transcript,evaluations"

Response

Session detail

Full roleplay session detail with optional transcript and evaluations.

id
string

Unique session identifier

user
object
scenario
object

A compact scenario reference for embedding in other responses.

score
number | null

Session score (0-100 scale)

rank
enum<string> | null

Performance rank based on score

Available options:
gold,
silver,
bronze,
unranked
duration_seconds
number | null

Session duration in seconds

is_valid_attempt
boolean

Whether this session counts as a valid graded attempt. A session is valid when it was completed (not abandoned), received AI grading, and has a score. Use valid attempts for analytics; non-valid sessions may be incomplete or ungraded.

outcome_feedback
string | null

Overall outcome summary from the AI evaluator

positive_feedback
string | null

What the participant did well

constructive_feedback
string | null

Areas for improvement

transcript
object[] | null

Conversation transcript lines, excluding system messages (only included when requested via ?include=transcript)

evaluations
object[] | null

Evaluation criteria with grades (only included when requested via ?include=evaluations)

created_at
string<date-time>

When the session was created