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

# List teams

`GET /teams`

## Request

- Base URL: `https://service.steady.space/api/v2`
- URL: `https://service.steady.space/api/v2/teams`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://app.steady.space/oauth/authorize`, token URL `https://app.steady.space/oauth/token`)
  - HTTP bearer

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

A page of active teams in the account.

- Team[]
  - `id` string, uuid, required
  - `name` string, required
  - `description` string, nullable
  - `private` boolean, required
  - `completion_tracking` boolean, required
  - `mood_tracking` boolean, required
  - `report_days` string[], required
  - `people` PersonRef[], required
    - `id` string, uuid, required
    - `name` string, required
  - `url` string, uri, required

## Other responses

- `<<`

---

[API](https://skmtc.dev/statushero/apis/steady-v2-rest-api.md) · [All operations](https://skmtc.dev/statushero/apis/steady-v2-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/statushero/apis/steady-v2-rest-api/revisions/a3ee255356cd?raw)