budgets

Get daily spend

Per-day token usage and cost, split by agent, for one calendar month, including judge evaluations. Costs are in each model's pricing currency unless convert_costs_to is set. Defaults to the current month; pass month=YYYY-MM to query history. Covers every environment the caller can access; environment_id limits it to one. group_by=model splits by model; group_by=context.<key> splits by a run context value such as context.customer_id, with context_value: null for runs that do not set it. Response includes running month total, projected end-of-month estimate when the month is in progress, and month-over-month trend versus the prior calendar month.

Required permission: budgets.view.

get/v1/projects/{project_id}/budgets/daily-cost

Request

  • Base URL: https://api.connic.co
  • URL: https://api.connic.co/v1/projects/{project_id}/budgets/daily-cost
  • 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 narrows the data within month

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 this month or last month.

current_total_tokensinteger required

Total tokens for the same period.

projected_amountsobject nullable required

Estimated end-of-month cost keyed by currency code, extrapolated from the average daily spend so far. Null unless the month is in progress and every call could be priced.

last_month_total_tokensinteger required

Total tokens for the previous calendar month.

trendsobject required

Change versus the previous month, keyed by currency code.

agentsstring[] required

Groups with usage or spend in the period, sorted by name. Null stands for runs without the context value.

Changes

No recorded changes to this operation across all 2 revisions of this API.