---
title: "Get current API usage and quota status"
method: GET
path: "/api/v1/usage"
tags: ["Account"]
---

# Get current API usage and quota status

`GET /api/v1/usage`

## Request

- Base URL: `https://app.serpmantics.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.serpmantics.com/api/v1/usage`
- Auth: `BearerAuth` (a scheme the document does not define)

Returns the current period's API guide usage (guides created through the API or MCP), quota limit, remaining count and the renewal date. Aligned on the Stripe subscription billing cycle, or on the calendar month (UTC) for a Conqueror account without a subscription. Does not consume credits. `enforced` tells whether the quota is enforced on the current window: when `true`, a guide creation through the API or MCP that would exceed the limit is refused with HTTP 402 (see `POST /api/v1/guides`). When `false` (any plan other than Conqueror, a billing cycle that started before the refusal went live, or a Conqueror subscription in payment recovery, counted over the last 30 days with no reset date), the figures are informational only and nothing is refused on quota grounds. `upgrade_url` is the absolute link to the "Priority and API volume" add-on (the same as `details.upgrade_url` of the 402), absent when the add-on cannot raise the quota (already at its highest volume, or account without a subscription to add it to).

## Response `200`

Current quota status

## Other responses

- `401`: Unauthorized

---

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