Query Single Thread Stats - Docs by LangChain

Error

A valid request URL is required to generate request examples

{
  "completion_cost": 123,
  "completion_cost_details": {
    "raw": {}
  },
  "completion_token_details": {
    "raw": {}
  },
  "completion_tokens": 123,
  "feedback_stats": {},
  "first_start_time": "2023-11-07T05:31:56Z",
  "last_end_time": "2023-11-07T05:31:56Z",
  "last_start_time": "2023-11-07T05:31:56Z",
  "latency_p50_seconds": 123,
  "latency_p99_seconds": 123,
  "prompt_cost": 123,
  "prompt_cost_details": {
    "raw": {}
  },
  "prompt_token_details": {
    "raw": {}
  },
  "prompt_tokens": 123,
  "total_cost": 123,
  "total_tokens": 123,
  "turns": 123
}

{
  "detail": "<string>",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "detail": "<string>",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "detail": "<string>",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "detail": "<string>",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "detail": "<string>",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "detail": "<string>",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "detail": "<string>",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "detail": "<string>",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

GET

threads

{thread_id}

stats

Error

A valid request URL is required to generate request examples

{
  "completion_cost": 123,
  "completion_cost_details": {
    "raw": {}
  },
  "completion_token_details": {
    "raw": {}
  },
  "completion_tokens": 123,
  "feedback_stats": {},
  "first_start_time": "2023-11-07T05:31:56Z",
  "last_end_time": "2023-11-07T05:31:56Z",
  "last_start_time": "2023-11-07T05:31:56Z",
  "latency_p50_seconds": 123,
  "latency_p99_seconds": 123,
  "prompt_cost": 123,
  "prompt_cost_details": {
    "raw": {}
  },
  "prompt_token_details": {
    "raw": {}
  },
  "prompt_tokens": 123,
  "total_cost": 123,
  "total_tokens": 123,
  "turns": 123
}

{
  "detail": "<string>",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "detail": "<string>",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "detail": "<string>",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "detail": "<string>",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "detail": "<string>",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "detail": "<string>",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "detail": "<string>",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

{
  "detail": "<string>",
  "instance": "<string>",
  "remedy": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "<string>"
}

Authorizations

X-API-Key

string

header

required

X-Tenant-Id

string

header

required

Path Parameters

thread_id

string

required

Thread ID

Query Parameters

filter

string

filter narrows which of the thread's traces are aggregated, using a LangSmith filter expression. For example: lt(start_time, "2025-01-01T00:00:00Z") or eq(trace_id, "0190a1b2-c3d4-7ef0-a5b6-6ea3a82e9328"). See https://docs.langchain.com/langsmith/trace-query-syntax#filter-query-language for syntax.

selects

enum<string>[]

required

selects lists which aggregate stats to compute and return (repeatable query parameter). At least one value is required. Accepts any value of SingleThreadStatsSelectField.

Available options:

TURNS,

FIRST_START_TIME,

LAST_START_TIME,

LAST_END_TIME,

LATENCY_P50,

LATENCY_P99,

PROMPT_TOKENS,

PROMPT_COST,

COMPLETION_TOKENS,

COMPLETION_COST,

TOTAL_TOKENS,

TOTAL_COST,

PROMPT_TOKEN_DETAILS,

COMPLETION_TOKEN_DETAILS,

PROMPT_COST_DETAILS,

COMPLETION_COST_DETAILS,

FEEDBACK_STATS

session_id

string<uuid>

required

session_id is the tracing project (session) UUID (required).

Response

aggregate stats for the thread

completion_cost

number

completion_cost is the sum of per-trace completion costs across the thread, in USD. Populated when COMPLETION_COST is selected.

completion_cost_details

object

completion_cost_details is the per-sub-category sum of completion cost details across the thread. Populated when COMPLETION_COST_DETAILS is selected.

Show child attributes

completion_token_details

object

completion_token_details is the per-sub-category sum of completion token details across the thread. Populated when COMPLETION_TOKEN_DETAILS is selected.

Show child attributes

completion_tokens

integer

completion_tokens is the sum of per-trace completion token counts across the thread. Populated when COMPLETION_TOKENS is selected.

feedback_stats

object

feedback_stats aggregates run-level feedback across the thread's traces, keyed by feedback key. Populated when FEEDBACK_STATS is selected.

Show child attributes

first_start_time

string<date-time>

first_start_time is the earliest trace start time in the thread (RFC3339). Populated when FIRST_START_TIME is selected.

last_end_time

string<date-time>

last_end_time is the latest trace end time in the thread (RFC3339). Populated when LAST_END_TIME is selected.

last_start_time

string<date-time>

last_start_time is the latest trace start time in the thread (RFC3339). Populated when LAST_START_TIME is selected.

latency_p50_seconds

number

latency_p50_seconds is the approximate p50 of trace latency across the thread, in seconds. Populated when LATENCY_P50 is selected.

latency_p99_seconds

number

latency_p99_seconds is the approximate p99 of trace latency across the thread, in seconds. Populated when LATENCY_P99 is selected.

prompt_cost

number

prompt_cost is the sum of per-trace prompt costs across the thread, in USD. Populated when PROMPT_COST is selected.

prompt_cost_details

object

prompt_cost_details is the per-sub-category sum of prompt cost details across the thread. Populated when PROMPT_COST_DETAILS is selected.

Show child attributes

prompt_token_details

object

prompt_token_details is the per-sub-category sum of prompt token details across the thread. Populated when PROMPT_TOKEN_DETAILS is selected.

Show child attributes

prompt_tokens

integer

prompt_tokens is the sum of per-trace prompt token counts across the thread. Populated when PROMPT_TOKENS is selected.

total_cost

number

total_cost is the sum of per-trace total costs across the thread, in USD. Populated when TOTAL_COST is selected.

total_tokens

integer

total_tokens is the sum of per-trace total token counts across the thread. Populated when TOTAL_TOKENS is selected.

turns

integer

turns is the number of distinct traces (turns) in the thread. Populated when TURNS is selected.

Query Threads

Query Thread Traces