Usage

Aggregate API usage stats

Returns token and call counts aggregated by operation_type and model over the requested date range. Default range is the last 30 days.

For organizations without the "Cost control endpoints" approval, breakdown[].model is redacted (omitted) and the response carries "cost_fields": "redacted". Approved organizations see the field unredacted and no cost_fields marker. This applies uniformly — every tenant, not just consumers of the per-document route.

get/v1/usage

Request

  • Base URL: https://api.talonic.com
  • URL: https://api.talonic.com/v1/usage
  • Auth: HTTP bearer

Query parameters

fromstring date-time

Start of the reporting window (ISO 8601). Default 30 days ago.

tostring date-time

End of the reporting window (ISO 8601). Default now.

Response

Aggregated usage stats.

cost_fields'redacted'

Present and set to "redacted" only for organizations without the "Cost control endpoints" approval — signals that breakdown[].model has been omitted. Absent for approved organizations.

Example response

{
  "period": {
    "from": "2026-04-25T14:30:00.000Z",
    "to": "2026-04-25T14:30:00.000Z"
  }
}

Changes

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