---
title: "Get teammate group"
method: GET
path: "/teammate_groups/{teammate_group_id}"
tags: ["Teammate groups"]
---

# Get teammate group

`GET /teammate_groups/{teammate_group_id}`

Fetch a teammate group.

Required scope: `teammate_groups:read`

## Path parameters

- `teammate_group_id` string, required

## Response `200`

A teammate group

- TeammateGroupResponse — A teammate group is a group of teammates in Front.
  - `_links` object, required
    - `self` string — Link to resource
    - `related` object
      - `teammates` string — Link to list of teammate members
      - `teams` string — Link to list of associated teams
      - `inboxes` string — Link to list of inboxes that teammate members can access
  - `id` string, required — Unique identifier of the teammate group
  - `name` string, required — The name of the teammate group
  - `description` string, nullable, required — Description of the teammate group
  - `is_managed_by_scim` boolean, required — Is teammate group managed by SCIM or by Front
  - `permissions` object, required — Permissions for the teammate group
    - `contacts` object — Permissions for teammate group access to contact lists
      - `access` string — Level of access for the teammate group to contact lists. Must be one of 'all', 'contact_lists', or 'none'.
      - `contact_list_ids` string[] — List of contact lists the teammate group is allowed to access. May only be specified if 'access' is set to 'contact_lists'.

---

[API](https://skmtc.dev/frontapp/apis/core-api.md) · [All operations](https://skmtc.dev/frontapp/apis/core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/frontapp/core-api/revisions/76d1eaa2d0eb/schema)