> For the complete documentation index, see [llms.txt](https://resolvedmarkets.com/llms.txt). Every docs page is also served as Markdown: append `.md` to its URL or send `Accept: text/markdown`.

# Subscription Status

### GET /v1/payments/subscription — Subscription Status

Returns the current Clerk Billing subscription status including active plan and tier info. Requires a Clerk browser session — an X-API-Key header alone returns 401.

**Example response**

```json
{
  "provider": "clerk",
  "plan": "pro",
  "tier": "pro",
  "creditsRemaining": 48500,
  "expiresAt": "2026-04-27T00:00:00.000Z",
  "limits": {
    "rpm": 300,
    "wsMax": 1,
    "historyHours": 0,
    "mcp": "full",
    "maxKeys": 5
  }
}
```
