access_policies8

ace1

agents5

alert_rules5

annotation_queues9

annotation-queues21

api-key6

audit-logs2

auth7

aws_marketplace1

backfills1

bulk-exports12

charts23

comments6

commits3

data_planes5

datasets30

directories3

evaluators7

examples16

experiment-view-overrides5

experiments1

features5

feedback14

feedback-configs4

fleet orgs1

fleet secrets4

fleet tenants1

fleet threads1

fleet users3

gateway-policies6

hub_environments4

info2

integrations2

issues4

issues-agent7

likes1

mcp4

mcp_vendors9

me5

model-price-map4

oauth19

optimization-jobs9

Organizations1

orgs59

ownerships3

playground-settings5

productfeedback2

prompt-webhooks6

prompts1

public17

repos9

run23

runs13

sandboxes52

SCIM Tokens5

service-accounts3

sessions2

settings2

tag-transitions1

tags5

tenant2

threads13

tools8

tracer-sessions26

TTL Settings2

ttl-settings2

usage2

usage-limits4

workspaces42

run

Stats Runs

Changed on Oct 16, 2026

Get all runs by query in body payload.

post/api/v1/runs/stats

Request

Base URL
https://api.smith.langchain.com
URL
https://api.smith.langchain.com/api/v1/runs/stats
Auth
- API key in header X-API-Key
- or API key in header X-Tenant-Id
- or HTTP bearer

Request body

idstring[] nullable

tracestring uuid nullable

Filter runs by trace ID. When set, limit and cursor-based pagination are not applied — all runs in the trace are returned in a single response.

parent_runstring uuid nullable

Enum for run types.

sessionstring[] required

reference_examplestring[] nullable

execution_orderinteger nullable

start_timestring date-time nullable

end_timestring date-time nullable

errorboolean nullable

querystring nullable

filterstring nullable

trace_filterstring nullable

tree_filterstring nullable

is_rootboolean nullable

data_source_type'current' | 'historical' | 'lite' | 'root_lite' | 'runs_feedbacks_rmt_wide'

Enum for run data source types.

skip_paginationboolean nullable

search_filterstring nullable

use_experimental_searchboolean

groupsstring[] nullable

selectRunStatsSelect[] nullable

reference_dataset_idstring uuid nullable

include_detailsboolean

Response

Successful Response

object required

Changes

Oct 16, 20261a8ee9358d81 Revision changes
- breaking
  the request property became required
- breaking
  request property list-of-types was narrowed by removing types null from media type application/json
- breaking
  the request property's minItems was increased to 1
- breaking
  the / response's property type changed from object to string for status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new group_count enum value to the request property //
May 27, 2026a0acb3a6a101 Revision changes
- breaking
  response property anyOf[subschema #1: RunStats]/completion_cost list-of-types was widened by adding types number to media type application/json of response 200
- breaking
  response property anyOf[subschema #1: RunStats]/cost_p50 list-of-types was widened by adding types number to media type application/json of response 200
- breaking
  response property anyOf[subschema #1: RunStats]/cost_p99 list-of-types was widened by adding types number to media type application/json of response 200
- breaking
  response property anyOf[subschema #1: RunStats]/prompt_cost list-of-types was widened by adding types number to media type application/json of response 200
- breaking
  response property anyOf[subschema #1: RunStats]/total_cost list-of-types was widened by adding types number to media type application/json of response 200
- breaking
  response property anyOf[subschema #2]/additionalProperties/completion_cost list-of-types was widened by adding types number to media type application/json of response 200
- breaking
  response property anyOf[subschema #2]/additionalProperties/cost_p50 list-of-types was widened by adding types number to media type application/json of response 200
- breaking
  response property anyOf[subschema #2]/additionalProperties/cost_p99 list-of-types was widened by adding types number to media type application/json of response 200
- breaking
  response property anyOf[subschema #2]/additionalProperties/prompt_cost list-of-types was widened by adding types number to media type application/json of response 200
- breaking
  response property anyOf[subschema #2]/additionalProperties/total_cost list-of-types was widened by adding types number to media type application/json of response 200
- breaking
  the // response's property type changed from string to number for status
- breaking
  the // response's property type changed from string to number for status
- breaking
  the // response's property type changed from string to number for status
- breaking
  the // response's property type changed from string to number for status
- breaking
  the // response's property type changed from string to number for status
- breaking
  the /// response's property type changed from string to number for status
- breaking
  the /// response's property type changed from string to number for status
- breaking
  the /// response's property type changed from string to number for status
- breaking
  the /// response's property type changed from string to number for status
- breaking
  the /// response's property type changed from string to number for status

Operation history

Stats Runs

Request

Request body

Response 200OK

Changes

Response