Traces

Get recent session data

Retrieves the most recent LLM session data from a specific trace stream within a time range. Sessions group multiple traces that share the same session ID. Returns session summaries including session IDs, trace counts, LLM usage statistics, cost, and timing information.

get/api/{org_id}/{stream_name}/traces/session

Request

Path parameters

org_idstring required

Organization name

stream_namestring required

Stream name

Query parameters

filterstring

filter, eg: a=b AND c=d

keywordstring

Case-insensitive substring match on the session's user id or conversation text (the input or output messages of any span in the session). Literal text: no wildcards or operators. Trimmed and capped at 256 characters; combined with filter using AND.

frominteger required

from

sizeinteger required

size

start_timeinteger required

start time

end_timeinteger required

end time

timeoutinteger

timeout, seconds

sort_bystring

Session field to sort by: end_time, user_id, trace_count, duration, gen_ai_usage_total_tokens, gen_ai_usage_cost, status (default: end_time)

sort_orderstring

Sort order: asc or desc (default: desc)

Response

Success

frominteger required
function_errorstring
has_moreboolean required
hitsobject[] required
sizeinteger required
tookinteger required
totalinteger required
trace_idstring

Changes

No recorded changes to this operation across all 1 revision of this API.