Get evaluator cost roll-ups
Returns a paginated list of per-evaluator LLM cost and token-usage totals for the requested time window.
Data source. All figures are sourced from Fiddler’s evaluator cost pipeline, which aggregates LLM call records hourly. Results are pre-aggregated totals for the requested window; individual call-level records are not returned by this endpoint.
What appears in items[]. Only evaluator rules that have made at
least one billable LLM call within the requested window appear.
Non-LLM-backed evaluators (embedding, PII detection, FTL trust models,
etc.) never write cost rows and are silently absent — omission is
semantically distinct from a zero. Deleted rules are included with
both evaluator_rule_id and evaluator_rule_name null (cost is a
spend ledger; deletion does not retract it).
cost_usd_estimated. Present on every item; null when unpriced
(provider did not return pricing information). A null value is not
the same as zero.
llm_models. Present on every item: the distinct LLM models
(provider/model) the item’s evaluator calls used in the window. It
lists which models were used, not how the cost splits between them.
null when no model information is available for the window.
UTC-hour snapping. Cost data is collected at hourly boundaries, so
start_time is snapped down to the containing UTC hour and end_time
is snapped up. The effective, snapped window is echoed back in
data.meta.time_range.
RBAC. Org Admins see every application in the organization.
All other callers see only applications in projects they can read
(APPLICATION: READ, held by Project Admin, Writer, and Viewer roles).
A caller with no project access receives an empty 200 for any
well-formed project_id or application_id, including unknown and
cross-organization ones — the access filter runs before the ID check.
An unknown or cross-organization ID for a caller who can read
projects returns 400 — not 403 — to avoid acting as an existence
oracle. A same-organization ID the caller cannot read returns an empty
200; a malformed ID is still 400.
Availability. The endpoint returns 503 when the evaluator cost
feature is not enabled on your Fiddler instance. Contact your Fiddler
Customer Success Manager if you receive this status.
Authorizations
Query Parameters
Exclusive upper bound, ISO 8601 with timezone offset or Z (a naive timestamp returns 400). Defaults to now (UTC) when omitted. Snapped up to the next UTC hour boundary before querying. The current partial hour is always empty — cost rows are written at the close of each hour. start_time >= end_time returns 400.
Controls the grouping granularity of items[]. One of:
both(default) — one item per (application, evaluator rule).application_id— one item per application, costs summed across all evaluator rules in that application.project_id— one item per project, costs summed across all applications and evaluator rules in that project.
project_id, application_id, both Response
Paginated evaluator cost items for the requested window. Returns an empty items array (not an error) when there is no data or the caller has no authorized applications.
Response object for paginated API responses.