---
title: "Get organization resource limits"
method: GET
path: "/organizations/{organizationID}/limits"
tags: ["Projects"]
---

# Get organization resource limits

`GET /organizations/{organizationID}/limits`

Retrieves the effective org-level limits, including project creation limits and branch configuration defaults. Project-specific overrides are not applied here.

## Path parameters

- `organizationID` string, required

## Response `200`

Effective resource limits for the organization

- OrganizationLimits — Full set of resource limits applicable to a project and its branches
  - `maxDescriptionLength` integer, required — Maximum character length allowed for project descriptions
  - `maxBranchesPerProject` integer, required — Maximum number of branches allowed per project
  - `maxInstancesPerBranch` integer, required — Maximum number of database instances allowed per branch
  - `minInstancesPerBranch` integer, required — Minimum number of database instances required per branch
  - `maxAllowedInstanceType` integer, required — Maximum VCPUs (in millicores) allowed per instance; instance types with a higher VCPUsRequest are unavailable
  - `maxBranchesPerHour` integer, required — Maximum number of branches that can be created in a rolling one-hour window
  - `maxStorageGBPerBranch` integer, required — Maximum storage in GiB (gigabytes) allowed per branch; 0 means no limit
  - `maxProjects` integer, required — Maximum number of projects allowed in the organization
  - `maxProjectsPerHour` integer, required — Maximum number of projects that can be created in a rolling one-hour window
  - `maxBranchesPerOrg` integer, required — Maximum number of active branches allowed across all projects in the organization

## Other responses

- `401` — Error response when authentication or authorization fails
- `403` — Error response when authentication or authorization fails
- `5XX` — Unexpected Error

## Changes

- **2026-07-17** `13e8257b7933` — 1 info
  - added the required property `allOf[#/components/schemas/EffectiveProjectLimits]/maxStorageGBPerBranch` to the response with the `200` status
- **2026-05-27** `4f62c0eb12c5` — 2 breaking, 1 info
  - the `allOf[#/components/schemas/EffectiveProjectLimits]/maxAllowedInstanceType` response's property type/format changed from `string`/`` to `integer`/`` for status `200`
  - removed the required property `allOf[#/components/schemas/EffectiveProjectLimits]/maxStorageGbPerBranch` from the response with the `200` status
  - added the required property `allOf[subschema #2]/maxBranchesPerOrg` to the response with the `200` status
- **2026-05-15** `80656f9f4858` — 1 info
  - endpoint added
- **2026-04-15** `a2cc5189d200` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/xataio/apis/xata-api/changes/organizations/:organizationID/limits/get.md)

---

[API](https://skmtc.dev/xataio/apis/xata-api.md) · [All operations](https://skmtc.dev/xataio/apis/xata-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/xataio/xata-api/revisions/16b3a31dfdf8/schema)