> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tradingnews.press/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Usage

> Check your plan tier and rate limit

This endpoint is **free** — it does not count against your rate limit.

## Response

<ResponseField name="tier" type="string">
  Your current plan. One of:

  * `starter` — \$20/mo, 1 req/min
  * `pro` — \$50/mo, 30 req/min, WebSocket access
  * `max` — \$100/mo, Pro features plus semantic search and per-ticker sentiment, 60 req/min
  * `expired` — 7-day grace window after cancellation, throttled to 1 req/min
  * `free` — never-subscribed key, blocked from API access
</ResponseField>

<ResponseField name="rate_limit" type="integer">
  Your per-minute request limit.
</ResponseField>

<ResponseField name="period_end" type="string?">
  ISO 8601 datetime when the current billing period ends. `null` if no active subscription.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "X-API-Key: YOUR_KEY" \
    "https://api.tradingnews.press/v1/account/usage"
  ```

  ```python Python theme={null}
  import httpx

  resp = httpx.get(
      "https://api.tradingnews.press/v1/account/usage",
      headers={"X-API-Key": "YOUR_KEY"}
  )
  usage = resp.json()
  print(f"Tier: {usage['tier']}, Rate limit: {usage['rate_limit']} req/min")
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "tier": "pro",
    "rate_limit": 30,
    "period_end": "2026-05-07T00:00:00Z"
  }
  ```
</ResponseExample>