---
title: "List Teams"
method: GET
path: "/teams"
tags: ["Team"]
---

# List Teams

`GET /teams`

Retrieves a list of all teams in the system. The response includes team details such as name, UUID, parent team information, and team hierarchy.

## Response `200`

Teams successfully retrieved

- TeamResponse — Response containing a list of teams and metadata
  - `data` Team[] — List of teams
    - `uuid` string — Unique identifier of the team
    - `name` string — Name of the team
    - `phrases` string[] — List of keywords or phrases associated with the team
    - `slackConnection` SlackConnection — Represents the Slack integration details for a team
      - `id` string — Slack connection identifier
      - `info` SlackTeamInfo — Information about a connected Slack team
        - `id` string — Slack team identifier
        - `name` string — Name of the Slack team
    - `domain` string — Domain associated with the team
    - `organizerJoinInternalMeetings` boolean — Whether team organizers can join internal meetings
    - `consentEmailEnabled` boolean — Whether email consent is enabled for the team
    - `parentTeamUUID` string — UUID of the parent team if this team is part of a hierarchy
    - `organizationUUID` string — UUID of the organization this team belongs to
    - `children` Team[] — List of child teams if this team has a hierarchical structure
  - `meta` Meta
    - `pageCount` integer
    - `totalRecords` integer
    - `pageNumber` integer
    - `pageSize` integer

## Other responses

- `401` — Authentication failed. Please provide a valid API key.
- `default` — Unexpected error occurred while retrieving teams

---

[API](https://skmtc.net/attention/apis/attention-service-v2.md) · [All operations](https://skmtc.net/attention/apis/attention-service-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/attention/attention-service-v2/revisions/5de55d3804cf/schema)