Preview release.These docs are a work in progress. Pages are still being written, links may break, and structure may shift without notice. Treat everything here as a draft and report issues onGitHub.
Get gateway DID Document
GET
/.well-known/did.json
const url = 'https://data.example.test/.well-known/did.json';const options = {method: 'GET'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://data.example.test/.well-known/did.jsonReturns the gateway-hosted DID Document in gateway issuer mode. Used by verifiers to resolve the signing key for signed response credentials (VC-JWT). Delegated issuer deployments mount the route but return provenance.did_document_unavailable.
Responses
Section titled “Responses”Successful response
Media typeapplication/did+json
DID Document.
object
key
additional properties
any
Examplegenerated
{}Requested provenance artefact is not available.
Media typeapplication/problem+json
RFC 9457 Problem Details, returned for every non-2xx response.
object
code
required
string
detail
required
string
request_id
required
string
status
required
integer format: int32
title
required
string
type
required
string format: uri
key
additional properties
any
Example
{ "code": "auth.missing_credential", "detail": "no credential provided in Authorization or x-api-key header", "request_id": "01ARZ3NDEKTSV4RRFFQ69G5FAV", "status": 401, "title": "Missing credential", "type": "https://registry-relay.dev/problems/auth/missing_credential"}default
Section titled “default”Problem Details error response.
Media typeapplication/problem+json
RFC 9457 Problem Details, returned for every non-2xx response.
object
code
required
string
detail
required
string
request_id
required
string
status
required
integer format: int32
title
required
string
type
required
string format: uri
key
additional properties
any
Example
{ "code": "auth.missing_credential", "detail": "no credential provided in Authorization or x-api-key header", "request_id": "01ARZ3NDEKTSV4RRFFQ69G5FAV", "status": 401, "title": "Missing credential", "type": "https://registry-relay.dev/problems/auth/missing_credential"}