---
title: "Plan limits and quotas"
method: GET
path: "/v1/limits"
---

# Plan limits and quotas

`GET /v1/limits`

## Request

- Base URL: `https://api.turos.app`
- URL: `https://api.turos.app/v1/limits`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Return the current organization's effective plan, billing state, and route quota windows.

## Response `200`

Successful response

- object
  - `object` 'limits', required
  - `orgId` string, required
  - `requestId` string, required
  - `recordedAt` string, date-time, required
  - `effectivePlanKey` string, required
  - `billingState` string, required
  - `quotas` object[], required
    - `meterClass` string, required
    - `limit` integer, required
    - `period` 'minute' | 'hour' | 'day', required
    - `allowed` boolean, required
    - `planKey` string, required
    - `billingState` string, required

## Other responses

- `default`: Contract-aware error response

---

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