Usage

Per-document API usage

Returns per-document API usage entries and totals. 404 if no usage records exist for the document.

For organizations without the "Cost control endpoints" approval, model and all cost fields (cost_estimate_usd on both totals and each entries[] row) are redacted (omitted), and the response carries "cost_fields": "redacted". Approved organizations see these fields unredacted and no cost_fields marker.

get/v1/usage/documents/{id}

Request

  • Base URL: https://api.talonic.com
  • URL: https://api.talonic.com/v1/usage/documents/{id}
  • Auth: HTTP bearer

Path parameters

idstring uuid required
Example:a1b2c3d4-e5f6-7890-abcd-ef1234567890

Resource UUID.

Response

Per-document usage breakdown.

document_idstring uuid required
cost_fields'redacted'

Present and set to "redacted" only for organizations without the "Cost control endpoints" approval — signals that model and all cost_estimate_usd fields have been omitted. Absent for approved organizations.

Example response

{
  "document_id": "f0e1d2c3-b4a5-9687-8765-432109876543",
  "entries": [
    {
      "created_at": "2026-04-25T14:30:00.000Z"
    }
  ]
}

Changes

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