---
title: "Read effective customer limits"
method: GET
path: "/v1/limits"
---

# Read effective customer limits

`GET /v1/limits`

## Request

- Base URL: `https://docs.greatwait.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.greatwait.dev/v1/limits`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer and API key in header `Greatwait-Environment` and API key in header `Greatwait-Project`

Read effective customer allowances for the verified organization. Deployment and organization revisions identify the policy used; infrastructure and other organizations' settings are excluded.

## Response `200`

Read effective customer limits

- object
  - `limits` object, required
    - `inlinePayloadBytes` integer, required
    - `partitionKeyCeiling` integer
    - `forecastHorizonSeconds` integer, required
    - `usageWindowDays` integer, required
  - `provenance` object, required
    - `inlinePayloadBytes` 'default' | 'global' | 'deployment' | 'organization', required
    - `partitionKeyCeiling` 'default' | 'global' | 'deployment' | 'organization'
    - `forecastHorizonSeconds` 'default' | 'global' | 'deployment' | 'organization', required
    - `usageWindowDays` 'default' | 'global' | 'deployment' | 'organization', required
  - `revision` object, required
    - `global` integer, required
    - `organization` integer, required

## Other responses

- `401`: Problem document. Possible codes at this status: authentication_required, credential_expired, credential_revoked.
- `403`: Problem document. Possible codes at this status: scope_missing.
- `409`: Problem document. Possible codes at this status: project_archived.
- `429`: Problem document. Possible codes at this status: rate_limited.
- `503`: Problem document. Possible codes at this status: capability_not_configured, service_unavailable.

---

[API](https://skmtc.dev/greatwait/apis/greatwait-v1.md) · [All operations](https://skmtc.dev/greatwait/apis/greatwait-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/greatwait/apis/greatwait-v1/revisions/6855bce23e72?raw)