---
title: "Get Recent Usage"
method: GET
path: "/billing/usage/recent"
tags: ["Billing"]
---

# Get Recent Usage

`GET /billing/usage/recent`

## Query parameters

- `page` integer — Page number (1-indexed)
- `page_size` integer — Items per page
- `start` string, nullable — Start date YYYY-MM-DD (inclusive)
- `end` string, nullable — End date YYYY-MM-DD (inclusive)
- `model` string, nullable — Filter by model name (substring match)
- `credit_type` string, nullable — Filter by credit type: subscription, regular, mixed, none
- `model_name` string, nullable — Exact model name match (distinct from ``model`` which is substring)
- `input_tokens` integer, nullable — Exact input_tokens match
- `output_tokens` integer, nullable — Exact output_tokens match
- `sort_by` string — Sort field: date, amount, total_tokens
- `sort_order` string — Sort direction: asc, desc

## Headers

- `authorization` string, nullable
- `x_session_token` string, nullable

## Response `200`

Successful Response

- PaginatedUsageSummaryResponse
  - `data` UsageEventSummary[], required
    - `date` string, date-time, required
    - `model` string, nullable
    - `input_tokens` integer, required
    - `cached_input_tokens` integer
    - `cache_write_input_tokens` integer
    - `output_tokens` integer, required
    - `vector_reads` integer, required
    - `vector_cost_usd` number, required
    - `memory_write_cost_usd` number, required
    - `credit_type` string, required
    - `amount_deducted_usd` number, required
  - `pagination` PaginationMeta, required
    - `page` integer, required
    - `page_size` integer, required
    - `total` integer, required
    - `total_pages` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/backboard/apis/backboard-api.md) · [All operations](https://skmtc.dev/backboard/apis/backboard-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/backboard/backboard-api/revisions/e732d11ca11a/schema)