---
title: "Teams"
description: "List the Incident Management teams in your organization, with a member count per team."
---

`GET /api/im/teams`

A **team** is the top-level ownership unit in Incident Management: every [schedule](./schedules), escalation policy, and incident belongs to exactly one team. This endpoint lists your organization's teams. Team and membership *writes* (create a team, invite/remove members) are managed from the dashboard today and are not yet part of this public API's documented surface.

## Authentication

Requires the base IM access every endpoint in this API needs: an IM-eligible role (`admin`, `editor`, or `responder`), or an organization-wide API token. Incident Management must be enabled for the organization.

## Example (cURL)

```bash
curl -X GET "$BASE_URL/api/im/teams" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"
```

## Response

`200 OK`: an array, ordered by name.

```json
[
  {
    "id": 3,
    "name": "Platform Team",
    "labelColor": "#4f46e5",
    "analyticsEnabled": true,
    "memberCount": 5
  }
]
```

## Common errors

- `401 Unauthorized` when not authenticated
- `403 Forbidden` (`imAccessDenied`) when using a customer-scoped token, or a session without an IM-eligible role
- `403 Forbidden` (`imNotEnabled`) when Incident Management is not enabled for the organization