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

# List Teams

`GET /v1/teams`

Retrieves information about teams the authenticated user has at least read-only access to.

The list of teams returned depends on whether the request was made using user or admin permissions. User permissions return teams the requesting user has access to. Admin permissions return all teams belonging to the account.

This endpoint is paginated.

## Query parameters

- `filter` 'include=memberonly'

## Headers

- `Lucid-Request-As` string

## Response `200`

OK. Returns a list of Team resources containing information about teams directly accessible to the authenticated user. If requesting as admin, the list includes all teams on the account. If a filter is specified, only teams matching the filter are returned.

- Team[]
  - `id` number — The unique ID for the team.
  - `name` string — The team's name.
  - `type` 'hidden' | 'closed' | 'open' — The type of the team
  - `created` string, date-time — Date and time when the team was created.
  - `archived` string, date-time, nullable — Date and time when the team was archived (if it has been archived).

---

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