# tinker billing

## **tinker billing**

View billing usage.

### tinker billing usage *STARTING_ON* *ENDING_BEFORE*

Show hourly billing usage for your organization.

STARTING_ON and ENDING_BEFORE are RFC 3339 timestamps aligned to UTC hour boundaries (e.g. 2026-07-13T00:00:00Z), at most 14 days apart. Returns one row per (hour x usage type x base model x session x user), annotated with the project the usage belongs to. Session user metadata comes as a separate per-session table (JSON output / --sessions-csv) to join on session_id. Quantities are raw tokens / gigabyte-hours; dollar amounts are not included. Data lags real time by up to a few hours.

There are no filter flags: export the window once and filter the CSV/JSON client-side.

Requires billing view access in your organization.

**Options:**

- `--csv PATH` — Write usage rows as CSV to PATH instead of table/JSON output ('-' for stdout)
- `--sessions-csv PATH` — Also write the per-session side-table (session_id + user_metadata) as CSV to PATH ('-' for stdout); join it against the usage rows on session_id