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

# Get Billing Usage Timeseries

`GET /billing/usage/timeseries`

Aggregated credits from ``requests`` for the settings usage chart.

## 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.
- `scope` 'team' | 'personal' — ``team`` (default) aggregates the active team's usage; ``personal`` narrows to the requesting user's own usage (home page toggle).

## Response `200`

Successful Response

- UsageTimeseriesResponse — Daily usage series for charts.
  - `points` UsageTimeseriesPoint[], required
    - `bucket_date` string, required — ISO date or datetime string
    - `total_credits` number, 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/revisions/31dfe831e079/schema)