---
title: "Get caller's current quota state"
method: GET
path: "/v1/quota"
tags: ["Account"]
---

# Get caller's current quota state

`GET /v1/quota`

## Request

- Base URL: `https://geo.thinair.co`
- URL: `https://geo.thinair.co/v1/quota`
- Auth: HTTP bearer

Returns the caller's plan, daily usage, remaining queries, and upgrade options. **Free to call** — never debits quota and never returns 429 (a quota-exhausted user must still be able to discover their state).

## Response `200`

Caller's quota snapshot.

- QuotaResponse: Caller's current quota — plan, daily usage, remaining, upgrade options. Mirrors the MCP `quota` tool response shape so REST and MCP stay symmetric.
  - `schema_version` 'v1', required
  - `mcp` object, required
    - `plan` string, required
    - `used_today` integer, required
    - `daily_limit` union, required
      - integer
      - 'unlimited'
    - `remaining_today` union, required
      - integer
      - 'unlimited'
    - `monthly_limit` union, required
      - integer
      - 'unlimited'
    - `price_per_month` string, required
    - `suggested_upgrade` string, nullable, required
    - `upgrade_url` string, nullable, required
    - `reset_at` string, required

## Other responses

- `401`: Authentication required or failed.

---

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