---
title: "Lists all teams"
method: GET
path: "/v2/teams"
tags: ["team"]
---

# Lists all teams

`GET /v2/teams`

Retrieve a list of teams by providing the parameters such as, name, namespace_id, and seller_id. Use the page_token to navigate through the pages and page_size to specify the number of teams returned per page.

## Query parameters

- `pageToken` string
- `pageSize` string, int64
- `sortOption` 'SORT_OPTION_ASC' | 'SORT_OPTION_DESC'
- `name` string
- `namespaceId` string
- `companyType` 'COMPANY_TYPE_RETAILER' | 'COMPANY_TYPE_MANUFACTURER'
- `isMemberOnly` boolean
- `sellerId` string
- `sortOptions.key` 'SORT_OPTION_KEY_NAME' | 'SORT_OPTION_KEY_UPDATED_AT'
- `sortOptions.order` 'SORT_OPTION_ORDER_ASC' | 'SORT_OPTION_ORDER_DESC'

## Response `200`

A list of teams and a pagination token.

- V2ListTeamsResponse
  - `teams` V2LTeamResp[]
    - `id` string — The unique identifier of the team.
    - `name` string — The name of the team.
    - `namespaceId` string — The unique identifier of the namespace.
    - `companyName` string — The name of the company to which the team belongs.
    - `companyWebsite` string — The URL of the company's website.
    - `companyPhone` string — The phone number of the company to which the team belongs.
    - `companyAddress` V2CompanyAddress
      - `addressLine` string — The primary address line, typically including the street address.
      - `postcode` string — The postal code for the address.
    - `companyType` 'COMPANY_TYPE_RETAILER' | 'COMPANY_TYPE_MANUFACTURER'
    - `industryType` 'INDUSTRY_TYPE_GROCERY' | 'INDUSTRY_TYPE_PHARMACEUTICALS' | 'INDUSTRY_TYPE_PET_SUPPLIES' | 'INDUSTRY_TYPE_LIQUOR' | 'INDUSTRY_TYPE_ELECTRONICS' | 'INDUSTRY_TYPE_HARDWARE' | 'INDUSTRY_TYPE_FASHION' | 'INDUSTRY_TYPE_OTHER'
    - `logoId` string — A unique identifier for the logo associated with the team.
    - `userIds` string[] — The unique identifiers of the users belonging to the team.
    - `businessIdentifier` string — A unique identifier used for various business-related purposes, such as a registration number, business license, or company house number. The specific identifier required may vary depending on the country or region where your company is located.
    - `reviewerEmail` string — The email address to be notified when a campaign requires review or when there is information about a low wallet balance. This field is applicable only to the Primary Retailer team.
    - `sellerId` string — An ID unique to a supplier or merchant that is provided by a Retailer. Ensure the ID entered matches what your retailer has provided.
    - `modifyTime` string, date-time — The timestamp indicating when the team was last modified.
    - `onBehalfOf` string — Specifies the entity responsible for funding advertisements, as required by local laws, such as the Digital Services Act in Europe.
  - `nextPageToken` string — Token to retrieve the next page of results.
  - `totalCount` string, int64 — Total count of records that exists.

## Other responses

- `400` — There was a problem with input.
- `401` — Login failed or token not valid.
- `403` — Login failed or token not valid.
- `default` — An unexpected error response.

---

[API](https://skmtc.net/citrusad/apis/citrus-auth-api.md) · [All operations](https://skmtc.net/citrusad/apis/citrus-auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/citrusad/citrus-auth-api/versions/a040003c7378/schema)