---
title: "List SCIM groups"
method: GET
path: "/scim/groups"
tags: ["SCIM"]
---

# List SCIM groups

`GET /scim/groups`

List SCIM groups for the organization. [Management key](/docs/guides/overview/auth/management-api-keys) required.

## Query parameters

- `offset` integer, nullable — Number of records to skip for pagination
- `limit` integer — Maximum number of records to return (max 100)
- `display_name` string — Exact match filter on display_name. Omitted or empty returns groups unfiltered by name (subject to offset/limit). When external_id is also present, both must match.
- `external_id` string — Exact match filter on external_id, e.g. the identity provider (such as Entra ID) group object ID. Omitted or empty returns groups unfiltered by external_id (subject to offset/limit). When display_name is also present, both must match.

## Response `200`

List of SCIM groups

- ListScimGroupsResponse
  - `data` ScimGroup[], required
    - `created_at` string, required
    - `display_name` string, required
    - `external_id` string, nullable, required
    - `id` string, uuid, required
    - `organization_id` string, required
    - `updated_at` string, required
  - `total_count` integer, required

## Other responses

- `401` — Unauthorized - Authentication required or invalid credentials
- `404` — Not Found - Resource does not exist
- `500` — Internal Server Error - Unexpected server error

## Changes

- **2026-09-24** `e3057082e9e6` — 2 info
  - added the new optional `query` request parameter `display_name`
  - added the new optional `query` request parameter `external_id`
- **2026-07-30** `99ec68927cee` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/openrouterteam/apis/openrouter-api/changes/scim/groups/get.md)

---

[API](https://skmtc.dev/openrouterteam/apis/openrouter-api.md) · [All operations](https://skmtc.dev/openrouterteam/apis/openrouter-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openrouterteam/apis/openrouter-api/revisions/31b1cd25caca?raw)