---
title: "Get quota usage and headroom"
method: GET
path: "/v1/quotas"
tags: ["public", "usage"]
---

# Get quota usage and headroom

`GET /v1/quotas`

## Request

- Base URL: `https://api.vozora.io`
- URL: `https://api.vozora.io/v1/quotas`
- Auth: API key in header `Authorization`

How much of each quota dimension the account has consumed and how much remains. effective_limit and remaining are null when the dimension is unlimited; enforced is false when the dimension is tracked but not yet blocking. A create refused for quota returns 422 quota_exceeded on POST /v1/instances — this route is how a client sees that coming.

## Response `200`

OK

- QuotaPublicQuotaUsage
  - `usage` QuotaPublicDimensionUsage[]
    - `committed` integer
    - `dimension` string
    - `effective_limit` integer
    - `effective_used` integer
    - `enforced` boolean
    - `pending` integer
    - `remaining` integer

## Other responses

- `401`: invalid or missing API key
- `403`: the key lacks usage:read
- `500`: Internal Server Error

---

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