---
title: "GET /v1/scim/groups/{id}"
method: GET
path: "/v1/scim/groups/{id}"
tags: ["SSOReadyService"]
---

# GET /v1/scim/groups/{id}

`GET /v1/scim/groups/{id}`

Gets a SCIM group in a SCIM directory.

## Path parameters

- `id` string, required

## Response `200`

OK

- GetSCIMGroupResponse
  - `scimGroup` SCIMGroup
    - `id` string — Unique identifier for this SCIM group.
    - `scimDirectoryId` string — SCIM directory this SCIM group belongs to.
    - `displayName` string — A human-friendly name for the SCIM group.
    - `deleted` boolean — Whether the SCIM group has been deleted or deprovisioned from its SCIM directory. Identity Providers are inconsistent about reliably deleting SCIM groups. Many Identity Providers will deprovision the users inside a group, but not the group itself. For this reason, it's typical to ignore this field until a specific need arises.
    - `attributes` object — Arbitrary, potentially nested, attributes the Identity Provider included about the group. Identity Providers are inconsistent about supporting sending custom attributes on groups. For this reason, it's typical to not rely on them until a specific need arises.

## Other responses

- `default` — Default error response

## Changes

- **2024-08-17** `9a895b843207` — 1 breaking, 5 warning, 1 info
  - the `scimGroup` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the optional property `scimGroup/attributes` from the response with the `200` status
  - removed the optional property `scimGroup/deleted` from the response with the `200` status
  - removed the optional property `scimGroup/displayName` from the response with the `200` status
  - …3 more
- **2024-08-13** `516b78b641b8` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/ssoready/apis/ssoreadyservice-api/changes/v1/scim/groups/:id/get.md)

---

[API](https://skmtc.dev/ssoready/apis/ssoreadyservice-api.md) · [All operations](https://skmtc.dev/ssoready/apis/ssoreadyservice-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ssoready/ssoreadyservice-api/revisions/0827d713f08e/schema)