List OIDC Client
GET/v3/config/extension/oidc/clients
Retrieves a list of all OpenID Connect clients configured for the organisation, including their verification request settings and configurations. The newest client comes first. System-managed clients are left out unless systemManaged is true. Each client holds clientSecret and callbackSecret in clear text.
Request
Query Parameters
Default value: 0
Number of records to skip for pagination. A negative or unreadable value falls back to 0.
Default value: 10
Maximum number of records to return per page.
Default value: false
Set to true to include the system-managed clients in the list. Any other value leaves them out.
Responses
- 200
- 400
- 401
- 500
List of clients
Response Headers
Cache-Control string
Indicates that the response should not be cached.
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- ]
clients object[]required
The ID of the client's configured presentation definition. A presentation definition belongs to at most one client.
The name of the client
The ID of the client
The secret of the client
The valid redirect URIs for the client. The redirect_uri of an authorisation request must match one of them exactly.
The web origins of your application.
The URI at which a sub value will be calculated and returned according to the sent presentation. Empty when the client uses identityMatchingAttributes.
The secret used to access the callbackURI. Required when callbackURI is set.
identityMatchingAttributes object
A map of credential identifiers to claim paths used as linking values for identity matching. Each key identifies a credential: the vct of an SD-JWT credential, the doctype of an mdoc credential, or a type value of a W3C credential. The value is the dot-separated path to the claim within that credential. The value of that claim becomes the sub. Empty when the client uses callbackURI.
Possible values: <= 140 characters
The text that describes the login to the user in the EUDI Wallet, for example Log in to your online bank account. Empty when the presentation definition has no transaction data.
The ID of the client's key
Indicates whether the client is system-managed or not. A system-managed client cannot be updated or deleted.
The time of the last update of the client, as a Unix timestamp in seconds
The time of the creation of the client, as a Unix timestamp in seconds
pagination objectrequired
Current page number
Total number of items available
Total number of pages based on limit
Number of items per page
Indicates if there's a previous page
Indicates if there's a next page
{
"clients": [
{
"presentationDefinitionId": "string",
"name": "string",
"clientId": "string",
"clientSecret": "string",
"redirectURIs": [
"string"
],
"allowedOrigins": [
"string"
],
"callbackURI": "string",
"callbackSecret": "string",
"identityMatchingAttributes": {
"urn:eudi:pid:1": "email"
},
"transactionDataAction": "Log in to your online bank account",
"kid": "string",
"systemManaged": true,
"updatedAt": 1747015200,
"createdAt": 1747011600
}
],
"pagination": {
"currentPage": 1,
"totalItems": 25,
"totalPages": 3,
"limit": 10,
"hasPrevious": false,
"hasNext": true
}
}
Bad request. The provider answers with error and error_description when offset or limit is not a number. The answer has errorCode and errorDescription when the Passwordless Login extension is not enabled.
Response Headers
- application/json
- Schema
- Example (from schema)
Schema
- Provider error
- API error
The error code, for example invalid_request, not_found or server_error
The reason for the error
{
"error": "invalid_request",
"error_description": "Invalid 'offset' or 'limit'"
}
Unauthorized
Response Headers
- application/json
- Schema
- Example (from schema)
Schema
{
"errorCode": 400,
"errorDescription": "Bad input parameter"
}
Internal server error. The answer has errorCode and errorDescription when it cannot reach the provider.
Response Headers
- application/json
- Schema
- Example (from schema)
Schema
- Provider error
- API error
The error code, for example invalid_request, not_found or server_error
The reason for the error
{
"error": "server_error",
"error_description": "Internal server error"
}