---
title: "Free-tier usage status"
method: GET
path: "/auth/free-tier-status"
tags: ["Authentication"]
---

# Free-tier usage status

`GET /auth/free-tier-status`

## Request

- Base URL: `https://riskmodels.app/api`
- URL: `https://riskmodels.app/api/auth/free-tier-status`
- Auth: HTTP bearer

Returns current daily usage and remaining quota for a free-tier API key. Authenticated with Bearer token. Returns HTTP 200 with `tier` field for non-free accounts.

## Response `200`

Free-tier usage status.

- object
  - `tier` string
  - `user_id` string
  - `usage` object
    - `queries_today` integer
    - `queries_this_month` integer
    - `remaining_today` integer
  - `limits` object
    - `queries_per_day` integer
    - `queries_per_minute` integer
  - `reset_date` string, date-time

## Other responses

- `401`: Missing or invalid Bearer token.
- `404`: No account found for this API key.

---

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