---
title: "List teams"
method: GET
path: "/organizations/{organization_id}/teams"
tags: ["Organization Teams"]
---

# List teams

`GET /organizations/{organization_id}/teams`

Lists the teams within an organization, newest first. Results are paginated: `page` defaults to 1 and `limit` defaults to 10. `limit` is capped by the server's configured maximum page size, which defaults to 100; a larger value is silently reduced to the cap rather than rejected, and values below the minimum fall back to the defaults. The `pagination` object in the response always reports the values actually applied.

## Path parameters

- `organization_id` string, required

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

OK

- ListOrganizationTeamsResponse
  - `data` OrganizationTeam[], required
    - `created_at` string, date-time, required
    - `description` string, nullable
    - `id` string, required
    - `metadata` object, nullable
    - `name` string, required
    - `organization_id` string, required
    - `slug` string, required
    - `updated_at` string, date-time, required
  - `pagination` Pagination, required
    - `has_more` boolean, required
    - `limit` integer, required
    - `page` integer, required
    - `total` integer, required
    - `total_pages` integer, required

## Changes

- **2026-08-27** `1a139f96a670` — 2 breaking
  - for the `query` request parameter `limit`, default value `10` was added
  - for the `query` request parameter `page`, default value `1` was added
- **2026-08-24** `def468b0d6ea` — 1 breaking, 4 info
  - the response's body type/format changed from `null, array`/`` to `object`/`` for status `200`
  - added the new optional `query` request parameter `limit`
  - added the new optional `query` request parameter `page`
  - added the required property `data` to the response with the `200` status
  - …1 more
- **2026-07-24** `3f0abf6aab3c` — 2 info
  - api tag `Organization Teams` added
  - api tag `Teams` removed
- **2026-07-09** `dad8e2644615` — 1 info
  - endpoint added
- **2026-07-08** `d2f9387037c5` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/authula/apis/authula-api/changes/organizations/:organization_id/teams/get.md)

---

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