Skip to main content

API

/.well-known/did.json

get

A public endpoint for GOV.UK Wallet and credential verifiers to retrieve the credential issuer’s public keys for verifying credentials

Responses

StatusDescriptionSchema
200

Credential issuer’s DID document.

{
  "@context": [
    "https://www.w3.org/ns/did/v1",
    "https://w3id.org/security/suites/jws-2020/v1"
  ],
  "id": "did:web:example-credential-issuer.gov.uk",
  "verificationMethod": [
    {
      "id": "did:web:example-credential-issuer.gov.uk#5dcbee863b5d7cc30c9ba1f7393dacc6c16610782e4b6a191f94a7e8b1e1510f",
      "type": "JsonWebKey2020",
      "controller": "did:web:example-credential-issuer.gov.uk",
      "publicKeyJwk": {
        "kty": "EC",
        "kid": "5dcbee863b5d7cc30c9ba1f7393dacc6c16610782e4b6a191f94a7e8b1e1510f",
        "crv": "P-256",
        "x": "6jCKX_QRrmTeEJi-uiwcYqu8BgMgl70g2pdAst24MPE",
        "y": "icPzjbSk6apD_SNvQt8NWOPlPeGG4KYU55GfnARryoY",
        "alg": "ES256"
      }
    }
  ],
  "assertionMethod": [
    "did:web:example-credential-issuer.gov.uk#5dcbee863b5d7cc30c9ba1f7393dacc6c16610782e4b6a191f94a7e8b1e1510f"
  ]
}
 DidResponse

Schemas

DidResponse

NameTypeRequiredDescriptionSchema
@context array true

An array of URL contexts which define the terms used in the DID document.
id string true

The unique identifier of the DID document.
verificationMethod array true

An array of verification methods (cryptographic public keys).

 VerificationMethod
assertionMethod array true

Array of DID URLs where each URL uniquely identifies a verification method within the DID document.

VerificationMethod

NameTypeRequiredDescriptionSchema
id string true
type string true
controller string true
publicKeyJwk object true PublicKeyJwk

PublicKeyJwk

NameTypeRequiredDescriptionSchema
kty string true

Key Type. The family of cryptographic algorithms used with the key.
kid string true

Key ID. Unique identifier to match a specific key.
crv string true

Curve. Cryptographic curve used with the key.
x string true

The “x” coordinate for the elliptic curve point.
y string true

The “y” coordinate for the elliptic curve point.
alg string true

Algorithm. The cryptographic algorithm used with the key.
This page was last reviewed on 5 March 2025. It needs to be reviewed again on 5 September 2025 .