---
title: "GET /api/v1/consulting/usage"
method: GET
path: "/api/v1/consulting/usage"
tags: ["Consulting"]
---

# GET /api/v1/consulting/usage

`GET /api/v1/consulting/usage`

Returns the authenticated subscriber's estimated weekly AI usage as a percentage. Monetary plan limits are never exposed.

## Cookies

- `billing_session` string

## Response `200`

Current weekly AI usage.

- object
  - `exhaustionReason` 'cost_ceiling' | 'turn_reservation' | 'weekly_limit' | 'null', nullable, required
  - `estimated` true, required
  - `periodStart` string, date-time, required
  - `remainingPercent` integer, required
  - `resetAt` string, date-time, required
  - `status` 'available' | 'exhausted', required
  - `usedPercent` integer, required

## Other responses

- `400` — The query or session cookie is invalid.
- `401` — No Product subscriber session exists.
- `503` — AI usage accounting is unavailable.

---

[API](https://skmtc.dev/expertschat/apis/billing-core-api.md) · [All operations](https://skmtc.dev/expertschat/apis/billing-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/expertschat/billing-core-api/revisions/c6d0e986ce32/schema)