---
title: "List usage limits"
method: GET
path: "/list_usage_limits"
tags: ["Usage Limits"]
---

# List usage limits

`GET /list_usage_limits`

## Request

- Base URL: `https://happy-animal-123.convex.cloud/api/v1`
- URL: `https://happy-animal-123.convex.cloud/api/v1/list_usage_limits`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - API key in header `Authorization`

Get all usage limit configs for a deployment.

## Response `200`

- ListUsageLimitsResponse
  - `usageLimits` UsageLimitConfigResponse[], required
    - `id` string, required
    - `metric` 'functionCalls' | 'databaseIoGb' | 'dataEgressGb' | 'searchQueryGb' | 'queryMutationComputeGbHours' | 'actionComputeConvexGbHours' | 'actionComputeNodeJsGbHours' | 'actionComputeCpuGbHours', required
    - `window` 'day' | 'month', required: The calendar-aligned window a limit is measured over.
    - `limitType` 'warning' | 'disable', required
    - `limit` integer, required
    - `enabled` boolean, required

---

[API](https://skmtc.dev/operatornest/apis/convex-deployment-api.md) · [All operations](https://skmtc.dev/operatornest/apis/convex-deployment-api/llms.txt) · [OpenAPI document](https://skmtc.dev/operatornest/apis/convex-deployment-api/revisions/bd0de6c553a7?raw)