Sign in
runs

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.

get/v2/traces/{trace_id}/runs

Path parameters

trace_idstring uuid required

Trace UUID

Query parameters

filterstring

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_timestring date-time required

max_start_time is the inclusive upper bound for run start_time (RFC3339 date-time).

min_start_timestring date-time required

min_start_time is the inclusive lower bound for run start_time (RFC3339 date-time).

project_idstring uuid required

project_id is the UUID of the tracing project that owns the trace.

selectsstring[]

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

Acceptstring

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"
    }
  ]
}

Changes

Changed in 2 of the 48 revisions of this API.24

  • a0acb3a6a10123See the full diff
    • ○

      the endpoint scheme security API Key AND Tenant ID was added to the API

      api-security-added

    • ○

      the endpoint scheme security Bearer Auth AND Tenant ID was added to the API

      api-security-added

    • ○

      the endpoint scheme security API Key was removed from the API

      api-security-removed

    • ○

      the endpoint scheme security Bearer Auth was removed from the API

      api-security-removed

    • ○

      the endpoint scheme security Tenant ID was removed from the API

      api-security-removed

    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ○

      added the non-success response with the status

      response-non-success-status-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 99490d1e837e1See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 15 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog