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

# List teams

`GET /v1/teams`

## Request

- Base URL: `https://api.ybug.io`
- URL: `https://api.ybug.io/v1/teams`
- Auth: HTTP bearer

Lists every team accessible to the current API token, reflecting the user’s membership and plan entitlements.

## Response `200`

Successful retrieval of the list of teams.

- TeamList
  - `teams` Team[]
    - `id` string
    - `name` string

## Other responses

- `401`: Unauthorized. Missing or invalid API token.
- `403`: Forbidden. The user does not have permission to access the resource, or the operation is restricted by the account plan.
- `429`: Too Many Requests. The rate limit for the client has been exceeded.
- `500`: Internal Server Error. An unexpected error occurred on the server.

---

[API](https://skmtc.dev/ybug/apis/ybug-api.md) · [All operations](https://skmtc.dev/ybug/apis/ybug-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ybug/apis/ybug-api/revisions/50f50cb05459?raw)