---
title: "Get a Team Mapping"
method: GET
path: "/v3/identity-provider/team-mappings"
tags: ["Auth Settings"]
---

# Get a Team Mapping

`GET /v3/identity-provider/team-mappings`

Fetch the IdP group to Konnect team mapping.

## Query parameters

- `page[size]` integer
- `page[number]` integer

## Response `200`

A paginated list response for a collection of team mappings.

- object
  - `meta` object — Contains pagination data.
    - `page` object — The page object.
      - `number` integer — Page number.
      - `size` integer — Page size.
      - `total` integer — Total number of results.
  - `data` object[]
    - `group` string — Group names.
    - `team_ids` string[] — Team ID's that belong to the specified group.

## Other responses

- `401` — Unauthenticated
- `403` — Permission denied
- `404` — Not Found
- `412` — Precondition Failed

## Changes

- **2026-09-25** `68d43091b84d` — 3 warning
  - added the new `401.00` enum value to the `status` response property for the response status `401`
  - added the new `403.00` enum value to the `status` response property for the response status `403`
  - added the new `404.00` enum value to the `status` response property for the response status `404`
- **2026-09-18** `f324fb7610e4` — 3 breaking, 18 info
  - the response's body type changed from no type to `object` for status `401`
  - the response's body type changed from no type to `object` for status `403`
  - the response's body type changed from no type to `object` for status `404`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `401`
  - …17 more
- **2025-08-22** `3c0154b2053a` — 12 breaking
  - the response property `data` became nullable for the status `200`
  - the response property `data/items/group` became nullable for the status `200`
  - the response property `data/items/team_ids` became nullable for the status `200`
  - the response property `detail` became nullable for the status `412`
  - …8 more

[Change history](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v3/identity-provider/team-mappings/get.md)

---

[API](https://skmtc.dev/kong/apis/konnect-api-go-sdk.md) · [All operations](https://skmtc.dev/kong/apis/konnect-api-go-sdk/llms.txt) · [OpenAPI document](https://skmtc.dev/kong/apis/konnect-api-go-sdk/revisions/ffdac1582857?raw)