Skip to main content

API

/.well-known/openid-credential-issuer

get

A public endpoint for the GOV.UK Wallet to retrieve metadata about the credential issuer.

Responses

StatusDescriptionSchema
200

Credential issuer’s metadata.

application/json

{
  "credential_issuer": "https://example-credential-issuer.gov.uk",
  "authorization_servers": [
    "https://token.account.gov.uk"
  ],
  "credential_endpoint": "https://example-credential-issuer.gov.uk/credential",
  "notification_endpoint": "https://example-credential-issuer.gov.uk/notification",
  "credential_configurations_supported": {
    "FishingLicenceCredential": {
      "format": "mso_mdoc",
      "doctype": "uk.gov.example-credential-issuer.fishingLicence.1",
      "cryptographic_binding_methods_supported": [
        "cose_key"
      ],
      "credential_signing_alg_values_supported": [
        "ES256"
      ],
      "credential_refresh_web_journey_url": "https://example-credential-issuer.gov.uk/fishing-refresh",
      "credential_validity_period_max_days": 90
    }
  }
}
 MetadataResponse

Schemas

MetadataResponse

NameTypeRequiredDescriptionSchema
credential_issuer string true

URL of the credential issuer.
credential_endpoint string true

URL of the credential issuer’s credential endpoint.
authorization_servers array true

Set containing the URL of the authorization server(s) the credential issuer relies on for authorization.
mdoc_iacas_uri string true

URL of the credential issuer’s Issuing Authority Certification Authority (IACA) endpoint.
notification_endpoint string false

URL of the credential issuer’s notification endpoint.
credential_configurations_supported object true

Information about the credential(s) issued by the credential issuer.

 CredentialConfigurationsSupported

CredentialConfigurationsSupported

Information about the credential(s) issued by the credential issuer.

NameTypeRequiredDescriptionSchema
fishingLicence object true

A credential issued by the credential issuer.

 FishingLicence

FishingLicence

A credential issued by the credential issuer.

NameTypeRequiredDescriptionSchema
format string true

Format of the credential.
doctype string true

The credential’s document type identifier.
cryptographic_binding_methods_supported array true

Set of methods available for cryptographically binding the issued credential.
credential_signing_alg_values_supported array true

Set of algorithms that the credential issuer uses to sign the credential.
credential_refresh_web_journey_url string true

The URL where your users can go through the credential refresh web journey in their browser.
credential_validity_period_max_days number true

The credential’s validity period in days once it’s issued.
This page was last reviewed on 9 June 2026. It needs to be reviewed again on 9 December 2026 by the page owner #di-mobile-wallet-tech-docs .