---
title: "Get a team by ID"
method: GET
path: "/v4/admin/teams/{team_id}"
tags: ["v4", "Admin"]
---

# Get a team by ID

`GET /v4/admin/teams/{team_id}`

## Path parameters

- `team_id` union, required
  - string, uuid
  - string

## Response `200`

Success

- SuccessResponseTeamSchema
  - `success` true, required — Flag for it request was successful
  - `data` TeamSchema, required
    - `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
  - `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
- `404` — Resource Not Found
- `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/5ea378187147/schema)