Public API Endpoint for Claude.ai Usage Limits

Preflight Checklist

• [x] I have searched existing requests and this feature hasn't been requested yet
• [x] This is a single feature request (not multiple features)

Problem Statement

Feature Request: Public API Endpoint for Claude.ai Usage Limits

Summary:
I'd like to request a simple API endpoint that returns my current Claude.ai usage status (messages remaining, reset time, current tier limits).

Use Case:
I want to build a desktop widget that displays my remaining usage at a glance, so I don't have to open the web interface or CLI just to check if I'm near my limit. This would help me plan my work sessions and avoid hitting limits mid-task.

What I've Tried:

• Browser automation to scrape the usage indicator (blocked, understandably)
• Local tracking via Claude Code (doesn't reflect server-side limits)
• Manual checking (works but interrupts workflow)

This seems low-lift since the data already exists and is displayed in the UI. Exposing it via API would enable the community to build useful integrations — system tray widgets, CLI tools, IDE extensions, etc.

Thanks for considering this.

Proposed Solution

Proposed Solution:
A simple authenticated endpoint like GET /api/usage that returns:

• Messages used in current period
• Messages remaining
• Reset timestamp
• Current plan/tier

Alternative Solutions

_No response_

Priority

Critical - Blocking my work

Feature Category

CLI commands and flags

Use Case Example

_No response_

Additional Context

_No response_