---
title: "Usage over time"
method: GET
path: "/client/usage/series"
tags: ["Usage"]
---

# Usage over time

`GET /client/usage/series`

## Request

- Base URL: `https://api.roar-ai.com`
- URL: `https://api.roar-ai.com/client/usage/series`
- Auth: HTTP bearer

A time series of spend and request volume for charting, rather than the totals `GET /client/usage` returns. Narrow with `from`/`to`, `keyId` and `model` (one model, exactly). Requires `usage:read`.

## Response `200`

One point per bucket. (Response shape not yet modelled in this spec.)

- object

## Other responses

- `403`: Key lacks usage:read

---

[API](https://skmtc.dev/roar-ai/apis/roar-ai-api.md) · [All operations](https://skmtc.dev/roar-ai/apis/roar-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/roar-ai/apis/roar-ai-api/revisions/37e4d0d5a7fe?raw)