Read credential issuer metadata

GET 
/v2/config/digital-wallet/openid/credential-issuer

Reads and checks the OID4VCI Credential Issuer Metadata of a credential issuer. Give the Credential Issuer Identifier, or the URL of its metadata document. The wallet reads the metadata from the .well-known/openid-credential-issuer location of that identifier, and refuses it when its credential_issuer is not exactly that identifier. The wallet removes the keys that its metadata model does not define, including signed_metadata, and returns the optional keys that the issuer left out with the value null. Each entry of display gets the default value Not Discoverable for location and description when the issuer gives no value. The wallet does not change the contents of credential_configurations_supported. Use its keys as credentialConfigurationIds of a wallet-initiated issuance.

Request

Query Parameters

credentialIssuer stringrequired
Possible values: non-empty
Credential Issuer Identifier, or the URL of its metadata document.
Example: https://demo-api.igrant.io/v2/organisation/62e29d4c1d75a55b4ecd0e50/service/version-01
version stringrequired
Possible values: [version_01]
Default value: version_01
Version of the OID4VCI specification that the wallet uses to read the metadata. The only value is version_01 (OpenID4VCI 1.0), which is also the default.
Example: version_01

Responses

200

The wallet read the issuer metadata.

Response Headers

application/json

Schema

Schema

credentialIssuerMetadata object

Credential Issuer Metadata of the issuer, as defined in OID4VCI. The object holds the endpoints of the issuer and the credential configurations that the issuer supports.

property name* any

Credential Issuer Metadata of the issuer, as defined in OID4VCI. The object holds the endpoints of the issuer and the credential configurations that the issuer supports.

Example (from schema)

{
  "credentialIssuerMetadata": {}
}

400

The parameter credentialIssuer is missing or not an absolute URL, the version is not supported, the wallet finds no metadata at the location of the identifier, the credential_issuer of the metadata does not match, or the wallet unit is not operational. The wallet also refuses this operation for a sandbox organisation.

Response Headers

application/json

Schema

Schema

errorCode integerrequired
errorDescription stringrequired

Example (from schema)

{
  "errorCode": 400,
  "errorDescription": "Bad input parameter"
}

401

Unauthorized

Response Headers

application/json

Schema

Schema

errorCode integerrequired
errorDescription stringrequired

Example (from schema)

{
  "errorCode": 400,
  "errorDescription": "Bad input parameter"
}

500

Internal server error

Response Headers

application/json

Schema

Schema

errorCode integerrequired
errorDescription stringrequired

Example (from schema)

{
  "errorCode": 400,
  "errorDescription": "Bad input parameter"
}

Loading...