{"version":"2.1.284","anchor":"status-line-json-gateway-spend-limit-gains-used-usd-limit","canonical_anchor":"status-line-json-gateway-spend-limit-gains-used-usd-limit","heading":"Gateway logins show dollar spend against the spend limit","tier":"use","area":"Terminal UI","url":"https:\/\/changelogs.core-directive.com\/v\/2.1.284\/e\/status-line-json-gateway-spend-limit-gains-used-usd-limit","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.284","markdown":"### Gateway logins show dollar spend against the spend limit\n\nFor gateway logins with a spend limit, the status line data and usage screen now include dollars used, the dollar limit and the period\n\n**What**\n\nThis applies when you sign in through a gateway, meaning your organisation routes Claude Code through its own server, and an overage (spend) limit is set.\n\n- Claude Code now reads `${url}\/api\/oauth\/usage` on the gateway to get the spend record: the monthly limit, the credits used, the currency and the active limit group.\n\n- The data passed to custom status line scripts now includes `used_usd`, `limit_usd` and an optional `period` under `rate_limits.spend_limit`, next to the existing `used_percentage` and `resets_at`. The status line is the bar at the bottom of the screen, which you can customise with your own script. The amounts are converted from cents to dollars.\n\n- The dollar figures are filled in only when the currency is USD and the record's reset time matches the overage limit's `resets_at`.\n\n- The usage settings panel shows the same figures for gateway users.\n\n- Reads are cached per sign-in. A failed read is logged as `[gateway-usage] read failed`.\n\n**Why**\n\nIf your team uses a gateway, you and your status line scripts can now see how many dollars you have spent against your limit, not just a percentage.\n\n- Area: Terminal UI\n- Names: `rate_limits.spend_limit`\n- Tier: Use it now\n- Useful: 4\/5\n- Signal: 2\/5"}