---
title: "Get quota usage history for the active organization"
method: GET
path: "/v1/quotas/usage"
tags: ["Quotas"]
---

# Get quota usage history for the active organization

`GET /v1/quotas/usage`

## Request

- Base URL: `https://api.prod.keyban.io`
- URL: `https://api.prod.keyban.io/v1/quotas/usage`
- Auth: `X-Api-Key` (a scheme the document does not define)

Retrieve monthly quota usage data for the current organization. Useful for building usage trend charts.

## Query parameters

- `months` number
- `organizationId` string, uuid

## Response `200`

Quota usage history retrieved successfully

- QuotaUsageListDtoOutput
  - `data` object[], required
    - `organization` string, uuid, required: UUID of the organization that owns this usage counter. Used to scope quota enforcement per tenant.
    - `subject` 'application' | 'dppPassport' | 'wallet', required: Discriminant identifying the type of resource being tracked (`application`, `dppPassport`, `wallet`). Scopes the counted actions to one resource family.
    - `period` string, date, required: ISO 8601 date (`YYYY-MM-DD`) representing the first day of the monthly quota window. Always set to the 1st of the month; resets each calendar month.
    - `count` integer, required: Total number of actions recorded on published/claimed passports for the period (all event types). Non-negative integer; mirrors what counts against the monthly quota.

---

[API](https://skmtc.dev/keyban/apis/keyban-rest-apis.md) · [All operations](https://skmtc.dev/keyban/apis/keyban-rest-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/keyban/apis/keyban-rest-apis/revisions/0bb79a1da961?raw)