---
title: "Get subscription quota and usage"
method: GET
path: "/quota"
tags: ["Usage"]
---

# Get subscription quota and usage

`GET /quota`

## Request

- Base URL: `https://api.data.jambase.com/v3`
- URL: `https://api.data.jambase.com/v3/quota`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/jambase/apis/jambase-concert-data-api/docs/quota/get.ts> (a function with typed inputs; its response is checked against the schema)

Accepts an API key Bearer token or supported OAuth Bearer token. Returns the effective quota and usage for the authenticated shared subscription pool. The effective quota includes applicable plan entitlements, overrides, and bonuses. This endpoint does not meter billing or analytics usage. Response rate-limit headers describe short-window abuse limits, not the subscription quota; overage values are not a provisional estimate of the final charge. For cost projections, use the Usage page.

## Response `200`

Current quota and usage

- object
  - `plan` string, required
  - `quota` integer, nullable, required
  - `usedCalls` integer, required
  - `remainingCalls` integer, nullable, required
  - `overageCalls` integer, required
  - `noMonthlyCap` boolean, required
  - `periodStart` string, date-time, required
  - `periodEnd` string, date-time, required
  - `periodSource` 'openmeter' | 'anchor' | 'calendar', required
  - `limitType` 'hard' | 'soft' | 'unlimited' | 'no_monthly_cap', required
  - `blocksAtQuota` boolean, required
  - `notes` object, required
    - `rateLimitHeaders` string, required: Rate-limit headers describe short windows, not monthly quota counters.
    - `overage` string, required: Overage calls are not a final invoice balance.

## Other responses

- `401`: Authentication credentials are missing or invalid.
- `403`: Authenticated caller is not authorized to view this subscription quota.
- `429`: Short-window abuse rate limit exceeded.
- `503`: Quota usage is temporarily unavailable because meter or entitlement data could not be read.

---

[API](https://skmtc.dev/jambase/apis/jambase-concert-data-api.md) - [All operations](https://skmtc.dev/jambase/apis/jambase-concert-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jambase/apis/jambase-concert-data-api/revisions/487fb580fa61?raw)