---
title: "List Teams"
method: GET
path: "/v1/accounts/{account_id}/teams"
tags: ["Teams"]
---

# List Teams

`GET /v1/accounts/{account_id}/teams`

**Authorization scope:** `team:list` 
 
 **Get all user teams**

## Path parameters

- `account_id` string, required

## Query parameters

- `page` integer
- `items_per_page` integer
- `display_name` string, nullable — The internal display name of the team
- `source` string, nullable — The team source local (rivery) or external (Active Directory)
- `remote_display_name` string, nullable — The remote display name of the team
- `sort_by` 'display_name' | 'created_at' | 'source' | 'is_all_environment_admin' | 'default_environment' — User teams sort properties in the UI.
- `sort_order` 'desc' | 'asc' — Sorting can be either asc or desc, used in the api-service
- `team_id` string[], nullable — List of team ids

## Response `200`

Successful Response

- UserTeamsListResponse — List user teams response
  - `next_page` string, nullable — The next page URL
  - `previous_page` string, nullable — The previous page URL
  - `page` integer — The page number
  - `current_page_size` integer, required — The current page size
  - `total_items` integer — The total number of entities fetched
  - `account_id` string, required — The account id
  - `items` UserTeamsModel[], required
    - `_id` string, required — The user group id
    - `account_id` string, required — The account id
    - `display_name` string, required — The display name
    - `remote_display_name` string, nullable — The SCIM display name
    - `description` string, nullable — Internal description
    - `environments` object — Dictionary of environment id and environment role
    - `default_environment` string, nullable — Default Environment ID for this team (Optional)
    - `is_all_environment_admin` boolean — Indicates if group have Admin permission for all environment
    - `source` 'rivery' | 'active_directory' — The source group. can be locally from Rivery or imported from external provider
    - `created_at` string, date-time, required — Created team datatime

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/rivery/apis/boomi-data-integration-api.md) · [All operations](https://skmtc.net/rivery/apis/boomi-data-integration-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rivery/boomi-data-integration-api/revisions/cd4c91e0e6c2/schema)