---
title: "Get Copilot Usage"
method: GET
path: "/api/chat/usage"
tags: ["v2", "chat", "chat"]
---

# Get Copilot Usage

`GET /api/chat/usage`

Get CoPilot usage status for the authenticated user.

Returns the percentage of the daily/weekly allowance used — not the
raw spend or cap — so clients cannot derive per-turn cost or platform
margins. Global defaults sourced from LaunchDarkly (falling back to
config). Includes the user's rate-limit tier.

## Response `200`

Successful Response

- CoPilotUsagePublic — Current usage status for a user — public (client-safe) shape.
  - `daily` UsageWindowPublic — Public view of a usage window — only the percentage and reset time. Hides the raw spend and the cap so clients cannot derive per-turn cost or reverse-engineer platform margins. ``percent_used`` is capped at 100.
    - `percent_used` number, required — Percentage of the window's allowance used (0-100). Clamped at 100 when over the cap.
    - `resets_at` string, date-time, required
  - `weekly` UsageWindowPublic — Public view of a usage window — only the percentage and reset time. Hides the raw spend and the cap so clients cannot derive per-turn cost or reverse-engineer platform margins. ``percent_used`` is capped at 100.
    - `percent_used` number, required — Percentage of the window's allowance used (0-100). Clamped at 100 when over the cap.
    - `resets_at` string, date-time, required
  - `tier` 'NO_TIER' | 'BASIC' | 'PRO' | 'MAX' | 'BUSINESS' | 'ENTERPRISE' — Subscription tiers with increasing cost allowances. Mirrors the ``SubscriptionTier`` enum in ``schema.prisma``. Once ``prisma generate`` is run, this can be replaced with:: from prisma.enums import SubscriptionTier
  - `reset_cost` integer — Credit cost (in cents) to reset the daily limit. 0 = feature disabled.

## Other responses

- `401` — Authentication required

---

[API](https://skmtc.net/significant-gravitas/apis/autogpt-agent-server.md) · [All operations](https://skmtc.net/significant-gravitas/apis/autogpt-agent-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/significant-gravitas/autogpt-agent-server/versions/382041c7ecb2/schema)