---
title: "Get Billing Usage Timeseries Tokens"
method: GET
path: "/billing/usage/timeseries-tokens"
tags: ["billing"]
---

# Get Billing Usage Timeseries Tokens

`GET /billing/usage/timeseries-tokens`

Token volume (input + output) bucketed by time interval.

## Query parameters

- `start_date` string, nullable — Range start (ISO date or datetime, UTC); ignored when full_history=true
- `end_date` string, nullable — Range end (ISO date or datetime, UTC); with full_history, caps the window
- `full_history` boolean — If true, span from the team's first request through end (or now); ignores start_date
- `interval_minutes` integer — Bucket width in minutes (default 1440 = daily). Values >= 10080 bucket by week and >= 43200 by month so long ranges stay bounded in point count.

## Response `200`

Successful Response

- TokenVolumeTimeseriesResponse — Token volume timeseries for charts.
  - `points` TokenVolumeTimeseriesPoint[], required
    - `bucket_date` string, required — ISO date or datetime string
    - `input_tokens` integer, required
    - `output_tokens` integer, required
    - `total_tokens` integer, required
    - `request_count` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/pioneer/apis/brain-api.md) · [All operations](https://skmtc.net/pioneer/apis/brain-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pioneer/brain-api/versions/31dfe831e079/schema)