Sign in
Trust Registry

Register a relying party

Register a relying party verifier origin for wallet presentation requests. Didit ID uses the origin when a request flows through the W3C Digital Credentials API. The new registration starts as active.

post/v1/relying-parties

Request body

namestring required

You set the relying party display name.

originstring uri required

You set the web origin for this relying party.

client_idstring

You optionally set the OpenID4VP (OpenID for Verifiable Presentations) client identifier.

trust_policystring

You optionally set the trust policy: tenant (default, inherit the tenant registry) or custom (per-relying-party trust rules).

Example request

{
  "name": "Campus Door",
  "origin": "https://door.acme.example",
  "client_id": "campus-door",
  "trust_policy": "tenant"
}

Response

The relying party was registered.

idstring uuid

You receive the UUID for this relying party registration.

namestring

You receive the relying party display name.

originstring uri

You receive the registered web origin for this relying party.

client_idstring

You receive the OpenID4VP (OpenID for Verifiable Presentations) client identifier. The captured value is an empty string when you do not set one.

statusstring

You receive the registration status for this relying party.

created_atstring date-time

You receive the timestamp when this relying party was registered.

trust_policystring

You receive the trust policy for this relying party: tenant (inherit the tenant trust registry) or custom (per-relying-party trust rules).

Example response

{
  "id": "66c7a3cd-de20-43ea-b06d-2f0e7a49fa5d",
  "name": "Campus Door",
  "origin": "https://door.acme.example",
  "status": "active",
  "created_at": "2026-07-02T23:33:35.172947+00:00",
  "trust_policy": "tenant"
}

Changes

Changed in 3 of the 8 revisions of this API.316

  • e4eddba665573See the full diff
    • ○

      added the new optional request property client_id

      new-optional-request-property

    • ○

      added the new optional request property trust_policy

      new-optional-request-property

    • ○

      added the optional property trust_policy to the response with the 201 status

      response-optional-property-added

  • 9addd64b04b1212See the full diff
    • ▲

      the origin request property type/format changed from string/ to string/uri

      request-property-type-changed

    • ▲

      removed the success response with the status 200

      response-success-status-removed

    • ●

      removed the request property client_id

      request-property-removed

    • ○

      removed the active enum value from the status response property for the response status 201

      response-property-enum-value-removed

    • ○

      removed the revoked enum value from the status response property for the response status 201

      response-property-enum-value-removed

  • 1ee4908e9af411See the full diff
    • ▲

      added required request body

      request-body-added-required

    • ○

      added the success response with the status 201

      response-success-status-added

    This revision also has 111 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog