---
title: "List teams in an organization"
method: GET
path: "/v2/teams"
tags: ["Teams"]
---

# List teams in an organization

`GET /v2/teams`

## Request

- Base URL: `https://thirdparty.qonto.com`
- URL: `https://thirdparty.qonto.com/v2/teams`
- Auth: OAuth 2
  - Authorization code: `https://oauth.qonto.com/oauth2/auth`
  - Token URL: `https://oauth.qonto.com/oauth2/token` scopes: `team.read`

OAuth scope: `team.read`

---

Get a list with all teams within the authenticated organization

---

A successful response will give a list with the attributes id and name of each team in the organization:

## Pagination

- The default number of items per page is 1, max items per page is 100. Pagination data is returned in the response : [See Schema here](https://api-doc.qonto.com/docs/business-api/c2NoOjI3NTA2MjA3-pagination).

## Query parameters

- `page` integer
- `per_page` integer

## Headers

- `X-Qonto-Staging-Token` string

## Response `200`

the response contains a list of all teams in the authenticated organization.

- object
  - `teams` object[]
    - `id` string, uuid: unique identifier of each team in the organization
    - `name` string: name of each team in the organization
  - `meta` Pagination
    - `current_page` integer
    - `next_page` integer, nullable
    - `prev_page` integer, nullable
    - `total_pages` integer
    - `total_count` integer
    - `per_page` integer

## Other responses

- `401`: returns an unauthorized error
- `403`: returns a forbidden error

## Changes

- **2025-01-24** (v2) `25208d6f9deb`: 2 breaking
  - the `meta/next_page` response's property type changed from no type to `integer` for status `200`
  - the `meta/prev_page` response's property type changed from no type to `integer` for status `200`

[Operation history](https://skmtc.dev/hiit-consulting-fr/apis/qonto/changes/v2/teams/get.md)

---

[API](https://skmtc.dev/hiit-consulting-fr/apis/qonto.md) - [All operations](https://skmtc.dev/hiit-consulting-fr/apis/qonto/llms.txt) - [OpenAPI document](https://skmtc.dev/hiit-consulting-fr/apis/qonto/revisions/25208d6f9deb?raw)