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

# List all teams

`GET /teams`

This will return a list of team objects for the App.

## Headers

- `Intercom-Version` '1.0' | '1.1' | '1.2' | '1.3' | '1.4' | '2.0' | '2.1' | '2.2' | '2.3' | '2.4' | '2.5' | '2.6' | '2.7' | '2.8' | '2.9' | '2.10' | '2.11' | '2.12' | '2.13' | '2.14' — Intercom API version.</br>By default, it's equal to the version set in the app package.

## Response `200`

successful

- TeamList — This will return a list of team objects for the App.
  - `type` 'team.list' — The type of the object
  - `teams` Team[] — A list of team objects
    - `type` string — Value is always "team"
    - `id` string — The id of the team
    - `name` string — The name of the team
    - `admin_ids` integer[] — The list of admin IDs that are a part of the team.
    - `admin_priority_level` AdminPriorityLevel, nullable — Admin priority levels for the team
      - `primary_admin_ids` integer[], nullable — The primary admin ids for the team
      - `secondary_admin_ids` integer[], nullable — The secondary admin ids for the team
    - `assignment_limit` integer, nullable — The assignment limit for the team. This field is only present when the team's distribution type is load balanced.
    - `distribution_method` string, nullable — Describes how assignments are distributed among the team members

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/intercom/apis/intercom-api.md) · [All operations](https://skmtc.net/intercom/apis/intercom-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/intercom/intercom-api/versions/9517e80f2642/schema)