budgets

Get spend per agent

Token usage and native-currency cost by agent for the chosen month (default: current), sorted by name. Each row includes an exact per-currency cost breakdown, agent and judge token usage, and run count. Covers every environment the caller can access; pass environment_id to limit to one. group_by=model ranks models; group_by=context.<key> ranks run context values such as context.customer_id, with context_value: null for runs that do not set it.

Required permission: budgets.view.

get/v1/projects/{project_id}/budgets/agent-ranking

Request

  • Base URL: https://api.connic.co
  • URL: https://api.connic.co/v1/projects/{project_id}/budgets/agent-ranking
  • Auth: HTTP bearer

Path parameters

project_idstring uuid required

ID of the project the API key belongs to.

Query parameters

monthstring nullable

Month in YYYY-MM format

environment_idstring uuid nullable

Restrict to one environment UUID

start_datestring date-time nullable

Exact range start; applies only together with end_date and replaces the month bounds

end_datestring date-time nullable

Exact range end (exclusive); applies only together with start_date

tz_offsetinteger nullable

UTC offset in minutes, with the sign inverted (-120 for UTC+2, 300 for UTC-5). Days are grouped in this timezone; defaults to UTC.

group_bystring

Group spend by 'agent', 'model', or a run context path such as 'context.customer_id'

convert_costs_to'EUR' | 'USD' nullable

Convert token costs to EUR or USD at the daily ECB reference rate of each model call

Response

Successful Response

monthstring required

Month in YYYY-MM format.

currenciesstring[] required

Currency codes with a nonzero cost in the results.

Changes

No recorded changes to this operation across all 1 revision of this API.