---
title: "List all teams"
method: GET
path: "/v4/admin/teams"
tags: ["v4", "Admin"]
---

# List all teams

`GET /v4/admin/teams`

## Query parameters

- `limit` integer
- `offset` integer
- `orderBy` 'created_at' | 'updated_at' | 'domain' | 'plan'
- `ascending` boolean
- `search` string, nullable
- `plans` string[], nullable

## Response `200`

Success

- SuccessResponsePaginatedTeamSchema
  - `success` true, required — Flag for it request was successful
  - `data` PaginatedTeamSchema, required
    - `data` TeamSchema[], required — List of items
      - `id` union — Team ID
        - string, uuid
        - string
      - `created_at` string, date-time — User created at
      - `updated_at` string, date-time — User updated at
      - `details` TeamDetailsSchema
        - `onboarding` TeamDetailsOnboardingSchema
          - `has_added_doc` boolean
          - `has_added_integration` boolean
          - `has_added_team_member` boolean
        - `timezone` string — Team timezone for date calculations (e.g. America/New_York)
        - `ssoEnabled` boolean — Whether SSO is enabled for the team
        - `ssoRequired` boolean — Whether SSO is required for the team
      - `domain` string, required — Team domain
      - `plan` 'free' | 'trial' | 'standard' | 'enterprise' — Team plan
      - `trial_end_at` string, date-time, nullable — Trial end timestamp
    - `limit` integer, required — Items per page
    - `offset` integer, required — Current offset
    - `orderedBy` string, required — Sort field
    - `ascending` boolean, required — Sort direction (true = ascending)
    - `total` integer, required — Total number of items matching the query across all pages
  - `meta` ResponseMeta
    - `requestId` string — Unique request identifier for tracing
    - `timestamp` string, date-time — Response timestamp (UTC)
    - `durationMs` integer, nullable — Request processing time in milliseconds

## Other responses

- `401` — Auth Invalid Token
- `403` — Forbidden Insufficient Permissions
- `422` — Validation Failed
- `426` — Business Quota Exceeded
- `500` — Internal Error

---

[API](https://skmtc.dev/definite/apis/defapi.md) · [All operations](https://skmtc.dev/definite/apis/defapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/definite/defapi/revisions/3943d8deb3be/schema)