---
title: "List all group mappings"
method: GET
path: "/group-mappings"
tags: ["Group Mappings"]
---

# List all group mappings

`GET /group-mappings`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/group-mappings`
- Auth: none declared

Returns all group mappings.

## Query parameters

- `multiContains` GroupMappingsGetParametersMultiContains
- `multiEquals` GroupMappingsGetParametersMultiEquals
- `multiStartsWith` GroupMappingsGetParametersMultiStartsWith
- `expand` string
- `skip` integer: Number of results to skip. Used for pagination.
- `limit` integer: Number of results to return. Used for pagination.
- `sort` 'name': Field to sort by. Default is name.
- `order` '-1' | '1': The sort direction: 1 for ascending or -1 for descending.

## Response `200`

The group mappings matching the specified query.

- GroupMappingsSsoGroupMappingsGetGroupMappingsResponse200
  - `results` IapMappingSchema: This is the schema for an IAP group mapping stored in Mongo
    - `externalGroup` string, required: name of the external group
    - `provenance` string, required: The AAA provider for the external group
    - `iapGroups` string[], required
  - `total` integer: The total number of documents

## Other responses

- `500`: Error response from API

## Changes

- **2026-10-31** `2095cc90e583`: 2 info
  - api tag `Group Mappings` added
  - api tag `groupMappings` removed

[Operation history](https://skmtc.dev/itential/apis/itential-2/changes/group-mappings/get.md)

---

[API](https://skmtc.dev/itential/apis/itential-2.md) - [All operations](https://skmtc.dev/itential/apis/itential-2/llms.txt) - [OpenAPI document](https://skmtc.dev/itential/apis/itential-2/revisions/2095cc90e583?raw)