Feature request: Usage/spending API endpoint + status line integration

Resolved 💬 2 comments Opened Jun 11, 2026 by marc-ada Closed Jun 14, 2026

Summary

There's currently no programmatic way to check monthly Claude usage or spending. This makes it impossible to surface account-level usage data in tooling like the Claude Code status line.

Requested changes

1. A usage/spending API endpoint

Something like GET /v1/usage (or under the Console API) that returns current-period spend and quota, e.g.:

{
  "period": "2026-06",
  "spent_usd": 100.00,
  "limit_usd": 500.00,
  "credits_remaining_usd": 400.00
}

2. Claude Code status line integration

Once the data is available, expose it as a status line variable so users can display something like $100/$500 in their status bar — similar to how the current session token cost is already shown.

Use case

Users on team/enterprise plans with configured usage limits (e.g. extra usage allocated by a company admin) have no way to monitor how much of their monthly budget they've consumed without visiting the Console web UI. A queryable endpoint would unlock status line widgets, shell aliases, and other lightweight monitoring tools.

Current workaround

Manual check at console.anthropic.com → Usage tab.

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗