---
title: "Changes to List Organizations"
method: GET
path: "/v2/orgs"
---

# Changes to List Organizations

`GET /v2/orgs`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 25 revisions.

- **2025-09-16** `05b99f06db87`: 7 info

## Changes

- **2025-09-16** `05b99f06db87`: 7 info
  - for the `query` request parameter `search`, the type was generalized from `string` to no type
  - added `#/components/schemas/BillingTierType` to the `items/usage_limits/allOf[subschema #1: UsageLimits]/billing_tier` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/BillingTier` from the `items/usage_limits/allOf[subschema #1: UsageLimits]/billing_tier` response property `allOf` list for the response status `200`
  - the `billing_tier` response's property default value changed from `free` to `trial` for the status `200`
  - the `mau` response's property default value changed from `1000` to `5000` for the status `200`
  - the `tenants` response's property default value changed from `20` to `50` for the status `200`
  - the `usage_limits` response's property default value changed from `{"mau":1000,"tenants":20,"billing_tier":"free"}` to `{"mau":5000,"tenants":50,"billing_tier":"trial"}` for the status `200`

---

[Operation](https://skmtc.dev/permit/apis/permit-io-api/docs/v2/orgs/get.md) - [API](https://skmtc.dev/permit/apis/permit-io-api.md) - [Page](https://skmtc.dev/permit/apis/permit-io-api/changes/v2/orgs/get)