Skip to content

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