---
title: "Gets paged response for teams associated with the current Company. Default page size is 20"
method: GET
path: "/teams/paged"
tags: ["teams"]
---

# Gets paged response for teams associated with the current Company. Default page size is 20

`GET /teams/paged`

Requires the privilege [`TEAMS_READ`](https://www.gremlin.com/docs/user-management/access-control/#privileges)

## Query parameters

- `pageSize` integer
- `pageToken` string

## Response `default`

default response

- PagedResponseTeamResponse
  - `pageNumber` integer
  - `pageSize` integer — The size of the page requested. If none was supplied this is a default value (depending on the endpoint). If the length of items is less than this number that means there are _no_ more pages to request. NOTE: if the length *is* equal there may or may not be additional pages to request, it is unknowable until they are requested
  - `pageToken` string — Supply this token on successive requests to retrieve the next page if there is one
  - `items` TeamResponse[]
    - `identifier` string — The identifier of this Team.
    - `companyId` string — The identifier of the company to which this Team belongs.
    - `name` string — The name of this Team.
    - `state` string — The state of this Team.
    - `clientVersions` object — A Map representing the minimum and maximum client versions authenticated with this Team.
    - `certificate` string — The PEM encoded certificate associated with this Team.
    - `certificateSetAt` string, date-time — The time of creation for the certificate credentials associated with this Team.
    - `certificateSetBy` string — The account that set the certificate credentials associated with this Team.
    - `secretSetAt` string, date-time — The time of creation of the secret associated with this Team.
    - `secretSetBy` string — The account that set the secret associated with this Team.
    - `production` boolean — Flag to determine if team is marked for production
    - `prefs` Prefs — Prefs for team
      - `autoAddUsers` boolean
      - `domain` string
      - `testRunRestrictionWindows` TestRunRestrictionWindow[]
        - `dayOfWeek` 'M' | 'T' | 'W' | 'Th' | 'F' | 'S' | 'Su', required
        - `windowsForDay` ScheduleWindow[], required
          - `start` string, required — Time in HH:mm format (24-hour)
          - `end` string, required — Time in HH:mm format (24-hour)
    - `defaultTeamRole` string — The default team role
    - `createdAt` string, date-time — An ISO8601 timestamp representing the time at which this team was created

## Other responses

- `401` — Authorization header missing or malformed. Please provide proper credentials in the authorization header.
- `403` — User requires privilege: TEAMS_READ

---

[API](https://skmtc.net/gremlin/apis/gremlin-api.md) · [All operations](https://skmtc.net/gremlin/apis/gremlin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gremlin/gremlin-api/revisions/36ee938323f0/schema)