---
title: "Get the IdP Configuration"
method: GET
path: "/v3/identity-provider"
tags: ["Auth Settings"]
---

# Get the IdP Configuration

`GET /v3/identity-provider`

Fetch the IdP configuration.

## Response `200`

A get action response of the IdP configuration.

- IdP — The IdP object contains the configuration data for the OIDC authentication integration. NOTE: The `openid` scope is required. Removing it could break the OIDC integration.
  - `issuer` string, uri
  - `login_path` string
  - `client_id` string
  - `scopes` string[]
  - `claim_mappings` object
    - `name` string
    - `email` string
    - `groups` string

## Other responses

- `400` — Bad Request
- `401` — Unauthenticated
- `403` — Permission denied
- `404` — Not Found

## Changes

- **2025-10-23** `8ab3ec3ed301` — 1 warning
  - added the new `type` enum value to the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
- **2025-08-22** `3c0154b2053a` — 9 breaking, 4 info
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/source` became nullable for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterDependentItem]/source` became nullable for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterMaximumLength]/source` became nullable for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterMinimumLength]/source` became nullable for the status `400`
  - …9 more
- **2025-08-14** `6333a0d3b095` — 4 info
  - the `email` response's property default value `email` was removed for the status `200`
  - the `groups` response's property default value `groups` was removed for the status `200`
  - the `name` response's property default value `name` was removed for the status `200`
  - the `scopes` response's property default value `email, openid, profile` was removed for the status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v3/identity-provider/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-service-production.skmtc.workers.dev/v1/apis/kong/konnect-api-go-sdk/revisions/7d3c634668f8/schema)