---
title: "Per-function credit consumption"
method: GET
path: "/v1/usage/credits"
tags: ["Usage"]
---

# Per-function credit consumption

`GET /v1/usage/credits`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/usage/credits`
- Auth: `ApiKeyAuth` (a scheme the document does not define)

Returns credit consumption grouped by platform function
(`operation_type`) from the customer-pay ledger, plus the total over the
window. Shows where credits went (extraction vs structuring vs
intelligence operations). Populates once metering is enforcing.

## Query parameters

- `days` integer

## Response `200`

Per-function credit consumption.

- object
  - `period_days` integer
  - `total_credits` integer
  - `by_function` object[]
    - `operation_type` string
    - `operations` integer
    - `credits` integer

## Other responses

- `401`: Missing or invalid API key.
- `429`: Daily rate limit exceeded.

---

[API](https://skmtc.dev/talonic/apis/talonic-api.md) · [All operations](https://skmtc.dev/talonic/apis/talonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talonic/apis/talonic-api/revisions/678fe5f8c9c3?raw)