GET /api/v1/metering/costs/summary

Note

Generated from the OpenAPI contract — do not edit by hand. Interactive explorer with full schemas: https://entherium.duckdns.org:8443/reference; frozen spec for this build: openapi.json. Group: metering.

Costs Summary

Cost + tokens + brave aggregated by day / contract / model / provider.

Auth: Authorization: Bearer <token> required

Request

curl -sS -X GET "https://entherium.duckdns.org:8443/api/v1/metering/costs/summary" \
  -H "Authorization: Bearer <token>"

Response 200

The contract carries no example for this response; schema: array of CostSummaryRow. Field-level shape: interactive explorer.

Returns

array of CostSummaryRow — Successful Response

Field	Type	Description
brave_calls	integer	Web-search API calls billed to this bucket.
cost_micro_usd	integer
key	string
runs	integer
total_tokens	integer

Parameters

Parameter	In	Required	Type	Default	Constraints	Description
group_by	query	no	"day" | "contract" | "model" | "provider"	"day"	day, contract, model, provider
ai_company_id	query	no	integer | null	—	—
from	query	no	string | null	—	date-time
to	query	no	string | null	—	date-time

Errors

Code	Meaning	Body
401	Missing or invalid authentication credentials	ErrorResponse
422	Validation Error	HTTPValidationError

Every error body is {detail, code?, request_id, doc_url} — request_id is the value to quote, doc_url points at the Errors reference.