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

# List teams

`GET /teams`

## Request

- Base URL: `https://api3.autarc.energy/v1`
- URL: `https://api3.autarc.energy/v1/teams`
- Auth: API key in header `X-Api-Key`

Returns the company's teams (as shown at `/team/teams`). Each item is the team row only (`id`, `name`, `status`). Inactive teams are included. Use `GET /teams/{teamId}/members` for the member list, or the `teams` array on `GET /team-members` to see which teams an employee belongs to.

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

A paginated list of company teams

- Teams
  - `items` Team[], required
    - `id` string, uuid, required
    - `name` string, required: Team name as shown on the Teams page.
    - `status` 'active' | 'inactive', required
  - `metadata` object, required
    - `page` integer, required: Current page of the results
    - `limit` integer, required: Number of results per page
    - `total` integer, required: Total number of teams matching the query

## Other responses

- `400`: Invalid request — missing or malformed fields, unsupported mime type or fileType, or empty file.

---

[API](https://skmtc.dev/autarc/apis/autarc-2-0-api.md) - [All operations](https://skmtc.dev/autarc/apis/autarc-2-0-api/llms.txt) - [OpenAPI document](https://skmtc.dev/autarc/apis/autarc-2-0-api/revisions/adfb20a40efc?raw)