---
title: "GET /teams/{teamIdOrName}"
method: GET
path: "/teams/{teamIdOrName}"
tags: ["teams"]
---

# GET /teams/{teamIdOrName}

`GET /teams/{teamIdOrName}`

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

## Path parameters

- `teamIdOrName` string, required

## Response `default`

default response

- 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/versions/70fe938a0b35/schema)