---
title: "Usage Quota"
method: GET
path: "/v1/usage/quota"
tags: ["usage"]
---

# Usage Quota

`GET /v1/usage/quota`

## Request

- Base URL: `https://api.tmcra.com`
- URL: `https://api.tmcra.com/v1/usage/quota`
- Auth: HTTP bearer

## Query parameters

- `subject` string, nullable

## Headers

- `X-TMCRA-On-Behalf-Of-Subject` string, nullable: Trusted subject attribution for server-side control-plane proxies. Requires a tokens:manage API key.

## Response `200`

Successful Response

- QuotaView
  - `ingest_raw_tokens` QuotaMetricView, required
    - `limit` integer, nullable
    - `remaining` integer, nullable
    - `used` integer, required
  - `plan` 'pilot'
  - `principal` string, required
  - `recall_requests` QuotaMetricView, required
    - `limit` integer, nullable
    - `remaining` integer, nullable
    - `used` integer, required
  - `tenant_id` string, required

## Other responses

- `422`: Validation Error

---

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