---
title: "Get Usage Status"
method: GET
path: "/billing/usage-status"
tags: ["billing"]
---

# Get Usage Status

`GET /billing/usage-status`

Get the user's current conversation usage status.
Returns plan tier, current usage count, limit, and reset date.
Free tier: 3 conversations per day, resets daily
Premium tier: unlimited conversations

## Response `200`

Successful Response

- UsageStatusResponse
  - `plan_tier` string, required
  - `conversation_count` integer, required
  - `limit` integer, nullable, required
  - `day_start_date` string, required
  - `resets_at` string, required

---

[API](https://skmtc.dev/tryscott/apis/one-shot-api.md) · [All operations](https://skmtc.dev/tryscott/apis/one-shot-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tryscott/one-shot-api/revisions/28bdface01df/schema)