---
title: "Get usage statistics"
method: GET
path: "/v1/credits/usage"
tags: ["Credits"]
---

# Get usage statistics

`GET /v1/credits/usage`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/credits/usage`
- Auth: HTTP bearer

Returns aggregated API usage stats grouped by operation type and model over the given period.

## Query parameters

- `days` integer

## Response `200`

Aggregated usage stats.

- object
  - `stats` object[], required
    - `operation_type` string
    - `model` string
    - `call_count` integer
    - `total_input_tokens` string: Summed input tokens (serialized as a string).
    - `total_output_tokens` string: Summed output tokens (serialized as a string).
    - `total_cache_read_tokens` string: Summed cache-read tokens (serialized as a string).
    - `total_cost_usd` string, nullable: Estimated total cost in USD (serialized as a string).
  - `period_days` integer, required

## 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)