Sign in

v8

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-05730512.7 KB
Trust Registry

Validate a trusted issuer

Validate a trusted issuer's trust anchor. Didit ID checks reachability and key resolution. You can use the result before relying on a new or changed issuer.

post/v1/trusted-issuers/{uuid}/validate

Path parameters

uuidstring uuid required

UUID of the trusted issuer registry entry to validate.

Request body

object required

Response

The trusted issuer object with a validation result.

idstring uuid

You receive the UUID for the trusted issuer registry entry.

namestring

You receive the trusted issuer display name.

issstring uri

You receive the issuer identifier that credentials must match.

trust_anchorstring

You receive the signing-key anchor type. https-jwks resolves through a JSON Web Key Set (JWKS) endpoint when one is configured.

jwks_uristring

You receive the JSON Web Key Set (JWKS) endpoint. The captured value is an empty string when the registry entry does not store one.

didstring

You receive the decentralized identifier for the issuer. The captured value is an empty string when the registry entry does not store one.

statusstring

You receive the trust-gate status for this issuer.

added_bystring

You receive the principal that registered this trusted issuer.

frameworkstring nullable

You receive the associated framework slug, or null when the issuer is not tied to one.

created_atstring date-time

You receive the timestamp when this trusted issuer was registered.

validation_statestring

You receive the trust-anchor validation state: unverified, verified, or failed.

last_validated_atstring date-time nullable

You receive the timestamp of the most recent validation run, or null when the issuer has never been validated.

Example response

{
  "id": "18d3239a-4a0e-412b-9487-17ce7dc3bb8e",
  "name": "Gov PID Issuer",
  "iss": "http://localhost:8011/v1/issuers/docs-external-issuer-9r79lx",
  "trust_anchor": "https-jwks",
  "status": "active",
  "added_by": "TenantPrincipal<docs-capture-6clew6:owner>",
  "framework": "acme-partner-framework-ypr5",
  "created_at": "2026-07-02T23:33:35.153496+00:00",
  "validation": {
    "reachable": true,
    "anchor_ok": true,
    "issuer_matches": true,
    "jwks_keys": 2,
    "status": "active",
    "validation_state": "unverified"
  },
  "validation_state": "unverified"
}