API

/.well-known/openid-credential-issuer

get

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

Responses

Status Description Schema

200

Status	Description	Schema
200	Credential issuer’s metadata. { "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": "jwt_vc_json", "credential_definition": { "type": [ "VerifiableCredential", "FishingLicenceCredential" ] }, "cryptographic_binding_methods_supported": [ "did" ], "credential_signing_alg_values_supported": [ "ES256" ], "proof_types_supported": { "jwt": { "proof_signing_alg_values_supported": [ "ES256" ] } } } } }	MetadataResponse

Credential issuer’s metadata.

{
  "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": "jwt_vc_json",
      "credential_definition": {
        "type": [
          "VerifiableCredential",
          "FishingLicenceCredential"
        ]
      },
      "cryptographic_binding_methods_supported": [
        "did"
      ],
      "credential_signing_alg_values_supported": [
        "ES256"
      ],
      "proof_types_supported": {
        "jwt": {
          "proof_signing_alg_values_supported": [
            "ES256"
          ]
        }
      }
    }
  }
}

MetadataResponse

Schemas

MetadataResponse

Name	Type	Required	Description	Schema
credential_issuer	string	true	URL of the credential issuer.
credential_endpoint	string	true	URL of the credential issuer’s credential endpoint.
notification_endpoint	string	false	URL of the credential issuer’s notification endpoint.
authorization_servers	array	true	Set containing the URL of the authorization server(s) the credential issuer relies on for authorization.
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.

Name	Type	Required	Description	Schema
fishingLicence	object	true	A credential issued by the credential issuer.	FishingLicence

FishingLicence

A credential issued by the credential issuer.

Name	Type	Required	Description	Schema
format	string	true	Format of the credential.
credential_definition	object	true	Description of the credential type.	CredentialDefinition
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.
proof_types_supported	object	true	Key proof(s) supported by the credential issuer.	ProofTypesSupported

CredentialDefinition

Description of the credential type.

Name	Type	Required	Description	Schema
type	array	true

ProofTypesSupported

Key proof(s) supported by the credential issuer.

Name	Type	Required	Description	Schema
jwt	object	true		Jwt

Jwt

Name	Type	Required	Description	Schema
proof_signing_alg_values_supported	array	true

This page was last reviewed on 9 June 2025. It needs to be reviewed again on 9 December 2025 .