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

# List Teams

`GET /organizations/teams`

## Request

- Base URL: `https://api.attention.tech/v2`
- URL: `https://api.attention.tech/v2/organizations/teams`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/attention/apis/attention-service-v2/docs/organizations/teams/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of all teams in the organization. The response includes team details such as name, UUID, and parent team information if applicable.

## Response `200`

Teams successfully returned

- 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`: Valid API key required
- `500`: Unexpected server error. Please try again later.

---

[API](https://skmtc.dev/attention/apis/attention-service-v2.md) - [All operations](https://skmtc.dev/attention/apis/attention-service-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/attention/apis/attention-service-v2/revisions/cd99c71f42bb?raw)