Get evaluator spend

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, and feedback_key may be supplied with group_by to narrow listing aggregations.

GET /v1/platform/evaluators/spend

Error

A valid request URL is required to generate request examples

200

{
  "groups": [
    {
      "dataset_id": "<string>",
      "dataset_name": "<string>",
      "days": [
        {
          "date": "<string>",
          "spend_usd": 123,
          "trace_count": 123
        }
      ],
      "evaluator_id": "<string>",
      "evaluator_name": "<string>",
      "prev_total_spend_usd": 123,
      "prev_total_trace_count": 123,
      "run_rule_id": "<string>",
      "run_rule_name": "<string>",
      "session_id": "<string>",
      "session_name": "<string>",
      "spend_limit": {
        "limit_usd": 123,
        "utilization_pct": 123,
        "window": "<string>"
      },
      "total_spend_usd": 123,
      "total_trace_count": 123
    }
  ],
  "period_end": "<string>",
  "period_start": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

Authorizations

API KeyTenant IDBearer Auth

X-API-Key · string · header · required

Query Parameters

group_by · string

Aggregation mode: 'evaluator', 'resource', or 'run_rule'. Mutually exclusive with entity filters.

evaluator_id · string

Filter to a specific evaluator (UUID). Mutually exclusive with group_by.

session_id · string

Filter to a specific project (UUID). Mutually exclusive with group_by.

dataset_id · string

Filter to a specific dataset (UUID). Mutually exclusive with group_by.

resource_id · string[]

Filter grouped results to evaluators attached to all supplied project or dataset IDs. Only valid with group_by.

type · string

Filter grouped results by evaluator type: 'llm' or 'code'. Only valid with group_by.

feedback_key · string

Filter grouped results by evaluator feedback key. Only valid with group_by.

period_start · string · required

Start of the 7-day window (YYYY-MM-DD).

Response

200

application/json

OK

groups · object[]

Show child attributes

period_end · string

period_start · string