---
title: "Get evaluator spend"
method: GET
path: "/api/v1/platform/evaluators/spend"
tags: ["evaluators"]
---

# Get evaluator spend

`GET /api/v1/platform/evaluators/spend`

## Request

- Base URL: `https://api.smith.langchain.com`
- URL: `https://api.smith.langchain.com/api/v1/platform/evaluators/spend`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in header `X-Tenant-Id`
  - HTTP bearer

Returns per-day LLM evaluator spend for the requested 7-day period, grouped by evaluator, resource, or run rule. Exactly one of group_by, evaluator_id, session_id, or dataset_id is required. resource_id, type, feedback_key, tag_value_id, and agent_id may be supplied with group_by to narrow listing aggregations.

## Query parameters

- `group_by` string
- `evaluator_id` string
- `session_id` string
- `dataset_id` string
- `resource_id` string[]
- `type` string
- `feedback_key` string
- `tag_value_id` string[]
- `agent_id` string
- `period_start` string, required

## Response `200`

OK

- EvaluatorsGetEvaluatorSpendResponse
  - `groups` EvaluatorsSpendGroup[]
    - `dataset_id` string
    - `dataset_name` string
    - `days` EvaluatorsSpendDay[]
      - `date` string
      - `spend_usd` number
      - `trace_count` integer
    - `evaluator_id` string
    - `evaluator_name` string
    - `prev_total_spend_usd` number
    - `prev_total_trace_count` integer
    - `run_rule_id` string
    - `run_rule_name` string
    - `session_id` string
    - `session_name` string
    - `spend_limit` EvaluatorsSpendLimit
      - `limit_usd` number
      - `utilization_pct` number
      - `window` string
    - `total_spend_usd` number
    - `total_trace_count` integer
  - `period_end` string
  - `period_start` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

## Changes

- **2026-10-16** `1a8ee9358d81`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/langchain-ai/apis/langsmith/changes/api/v1/platform/evaluators/spend/get.md)

---

[API](https://skmtc.dev/langchain-ai/apis/langsmith.md) - [All operations](https://skmtc.dev/langchain-ai/apis/langsmith/llms.txt) - [OpenAPI document](https://skmtc.dev/langchain-ai/apis/langsmith/revisions/7a01c01f75e8?raw)