List runs in a trace
Alpha: The request and response contract may change; Returns runs for a trace ID within min/max start time. Optional filter; repeatable selects to select fields to return.
Path parameters
Trace UUID
Query parameters
filter narrows which runs within this trace are returned, using a LangSmith filter expression evaluated against each run. For example: eq(run_type, "llm") for LLM runs only, or eq(status, "error") for failed runs. See https://docs.langchain.com/langsmith/trace-query-syntax#filter-query-language for syntax.
max_start_time is the inclusive upper bound for run start_time (RFC3339 date-time).
min_start_time is the inclusive lower bound for run start_time (RFC3339 date-time).
project_id is the UUID of the tracing project that owns the trace.
selects lists which properties to include on each returned run (repeatable query parameter). Accepts any value of the RunSelectField enum. If omitted, only id is returned.
Headers
application/json
Response
OK
Example response
{
"items": [
{
"app_path": "/app/chains/chat.py:invoke",
"completion_cost": 0.0003,
"completion_tokens": 150,
"dotted_order": "20240115T103000000000Z018e4c7ea9fb7ef0a5b66ea3a82e9327.",
"end_time": "2024-01-15T10:30:01.500Z",
"error": "context deadline exceeded",
"events": [
{
"name": "new_token",
"time": "2024-01-15T10:30:00.312Z"
}
],
"first_token_time": "2024-01-15T10:30:00.312Z",
"id": "018e4c7e-a9fb-7ef0-a5b6-6ea3a82e9327",
"is_in_dataset": true,
"is_root": true,
"latency_seconds": 1.523,
"name": "ChatOpenAI",
"parent_run_ids": [
"018e4c7e-a9fb-7ef0-a5b6-6ea3a82e9327",
"a1b2c3d4-e5f6-4a5b-8c9d-0e1f2a3b4c5d"
],
"price_model_id": "e5f6a7b8-c9d0-4e1f-2a3b-4c5d6e7f8a9b",
"project_id": "018e4c7e-a9fb-7ef0-a5b6-6ea3a82e9327",
"prompt_cost": 0.0002,
"prompt_tokens": 200,
"reference_dataset_id": "c3d4e5f6-a7b8-4c5d-0e1f-2a3b4c5d6e7f",
"reference_example_id": "b2c3d4e5-f6a7-4b5c-9d0e-1f2a3b4c5d6e",
"share_url": "https://smith.langchain.com/public/4f7a1b2c-8d9e-4a0b-9c1d-2e3f4a5b6c7d/r",
"start_time": "2024-01-15T10:30:00.000Z",
"tags": [
"production",
"gpt-4"
],
"thread_id": "d4e5f6a7-b8c9-4d5e-1f2a-3b4c5d6e7f8a",
"total_cost": 0.000525,
"total_tokens": 350,
"trace_id": "018e4c7e-a9fb-7ef0-a5b6-6ea3a82e9327"
}
]
}