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

# Get Usage

`GET /api/chat/usage`

## Request

- Base URL: `https://api.earmarkiq.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.earmarkiq.app/api/chat/usage`
- Auth: HTTP bearer

Get the user's AI chat usage for today and this month.

## Response `200`

Successful Response

- UsageResponse
  - `messages_used_today` integer, required
  - `messages_remaining` integer, nullable, required
  - `is_premium` boolean, required
  - `daily_limit` integer, nullable, required
  - `subscription_tier` string
  - `monthly_limit` integer, nullable
  - `messages_used_this_month` integer
  - `tokens_used` integer
  - `token_budget` integer
  - `tokens_remaining` integer

---

[API](https://skmtc.dev/earmarkiq/apis/earmark-api.md) · [All operations](https://skmtc.dev/earmarkiq/apis/earmark-api/llms.txt) · [OpenAPI document](https://skmtc.dev/earmarkiq/apis/earmark-api/revisions/4a2c41907105?raw)