> ## Documentation Index
> Fetch the complete documentation index at: https://offstage.cloud/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> To set up offstage cloud from a coding agent, read https://api.offstage.cloud/SKILL.md and follow it. The whole API guide is one file at https://api.offstage.cloud/llms.txt.

# Usage

> What your team ran and spent, day by day.

`GET /v1/usage?days=30` (1 to 90 days, with a key or a session) answers with this shape:

```json theme={null}
{
  "period": "2026-10",
  "from": 1790812800000, "to": 1793000000000,
  "totals": { "seconds": 5400, "costUsd": 0.369, "tasks": 12, "sandboxes": 3 },
  "daily": [{ "date": "2026-10-01", "seconds": 120, "costUsd": 0.0082, "tasks": 1, "sandboxes": 0 }],
  "byKey": [{ "keyId": "key_…", "name": "ci", "seconds": 3600, "costUsd": 1.2 }]
}
```

* `daily` has one row per UTC day in the window, zeros included. Work counts on the day it ended, and work still running counts up to now.
* A `byKey` row with `keyId: null` is work started from the console.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.