---
title: "Get your plan limits"
method: GET
path: "/v1/quota"
tags: ["quota"]
---

# Get your plan limits

`GET /v1/quota`

## Request

- Base URL: `https://api.pomerado.ai`
- URL: `https://api.pomerado.ai/v1/quota`
- Auth: HTTP bearer

Returns your plan's limits and current use: tool calls per UTC day and integrations created per UTC month. A Business account's limits are one pool shared by every member, unlimited unless Pomerado sets one.

## Response `200`

Your allowances

- Quota
  - `as_of` string, required
  - `tool_calls` union, required: Tool calls today, by the UTC day
    - object
      - `status` 'ready', required
      - `period` 'day' | 'month', required
      - `period_start` string, required
      - `resets_at` string, required
      - `limit` integer, nullable, required: a non-negative number
      - `used` integer, required: a non-negative number
      - `reserved` integer, required: Started and not yet confirmed or released
      - `remaining` integer, nullable, required: a non-negative number
    - object
      - `status` 'unavailable', required
      - `reason` 'not_initialized' | 'partial_history', required
  - `integrations_created` union, required: Successful builds this UTC month, including builds that add a tool to an existing integration. Failed, cancelled and empty builds don't count
    - object
      - `status` 'ready', required
      - `period` 'day' | 'month', required
      - `period_start` string, required
      - `resets_at` string, required
      - `limit` integer, nullable, required: a non-negative number
      - `used` integer, required: a non-negative number
      - `reserved` integer, required: Started and not yet confirmed or released
      - `remaining` integer, nullable, required: a non-negative number
    - object
      - `status` 'unavailable', required
      - `reason` 'not_initialized' | 'partial_history', required

## Other responses

- `400`: invalid_request
- `401`: unauthorized, reauthentication_required
- `403`: forbidden
- `500`: internal_error
- `503`: temporarily_unavailable

---

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