List Linked Identity Providers
POSThttps://$CUSTOM-DOMAIN/management/v1/policies/login/idps/_search
Returns a list of identity providers that are linked in the login policy. This means, that they are configured for the organization and will be shown to the users. They will be shown if the organization is identified (per scope or user).
Request​
Header Parameters
x-zitadel-orgid string
The default is always the organization of the requesting user. If you like to get/set a result of another organization include the header. Make sure the user has permission to access the requested data.
- application/json
- application/grpc
- application/grpc-web+proto
Body
required
query
object
Body
required
query
object
Body
required
query
object
Responses​
- 200
- default
A successful response.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
details
object
result
object[]
{
"details": {
"totalResult": "2",
"processedSequence": "267831",
"viewTimestamp": "2025-03-25T10:28:47.875Z"
},
"result": [
{
"idpId": "69629023906488334",
"idpName": "google",
"idpType": [
"IDP_TYPE_OIDC"
]
}
]
}
- Schema
- Example (from schema)
Schema
details
object
result
object[]
{
"details": {
"totalResult": "2",
"processedSequence": "267831",
"viewTimestamp": "2025-03-25T10:28:47.875Z"
},
"result": [
{
"idpId": "69629023906488334",
"idpName": "google",
"idpType": [
"IDP_TYPE_OIDC"
]
}
]
}
- Schema
- Example (from schema)
Schema
details
object
result
object[]
{
"details": {
"totalResult": "2",
"processedSequence": "267831",
"viewTimestamp": "2025-03-25T10:28:47.875Z"
},
"result": [
{
"idpId": "69629023906488334",
"idpName": "google",
"idpType": [
"IDP_TYPE_OIDC"
]
}
]
}
An unexpected error response.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
code int32
message string
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
code int32
message string
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
code int32
message string
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- curl
- python
- go
- nodejs
- ruby
- csharp
- php
- java
- powershell
- CURL
curl -L 'https://$CUSTOM-DOMAIN/management/v1/policies/login/idps/_search' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
"query": {
"offset": "0",
"limit": 100,
"asc": true
}
}'
ResponseClear