---
title: "Register a relying party"
method: POST
path: "/v1/relying-parties"
tags: ["Trust Registry"]
---

# Register a relying party

`POST /v1/relying-parties`

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.

## Request body

- object
  - `name` string, required — You set the relying party display name.
  - `origin` string, uri, required — You set the web origin for this relying party.
  - `client_id` string — You optionally set the OpenID4VP (OpenID for Verifiable Presentations) client identifier.
  - `trust_policy` string — You optionally set the trust policy: `tenant` (default, inherit the tenant registry) or `custom` (per-relying-party trust rules).

## Response `201`

The relying party was registered.

- object
  - `id` string, uuid — You receive the UUID for this relying party registration.
  - `name` string — You receive the relying party display name.
  - `origin` string, uri — You receive the registered web origin for this relying party.
  - `client_id` string — You receive the OpenID4VP (OpenID for Verifiable Presentations) client identifier. The captured value is an empty string when you do not set one.
  - `status` string — You receive the registration status for this relying party.
  - `created_at` string, date-time — You receive the timestamp when this relying party was registered.
  - `trust_policy` string — You receive the trust policy for this relying party: `tenant` (inherit the tenant trust registry) or `custom` (per-relying-party trust rules).

## Changes

- **2026-07-05** `e4eddba66557` — 3 info
  - added the new optional request property `client_id`
  - added the new optional request property `trust_policy`
  - added the optional property `trust_policy` to the response with the `201` status
- **2026-07-03** `9addd64b04b1` — 2 breaking, 1 warning, 2 info
  - the `origin` request property type/format changed from `string`/`` to `string`/`uri`
  - removed the success response with the status `200`
  - removed the request property `client_id`
  - removed the `active` enum value from the `status` response property for the response status `201`
  - …1 more
- **2026-06-30** `1ee4908e9af4` — 1 breaking, 1 info
  - added required request body
  - added the success response with the status `201`

[Change history](https://skmtc.dev/didit-protocol/apis/didit-credentials-api/changes/v1/relying-parties/post.md)

---

[API](https://skmtc.dev/didit-protocol/apis/didit-credentials-api.md) · [All operations](https://skmtc.dev/didit-protocol/apis/didit-credentials-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/didit-protocol/didit-credentials-api/revisions/e4eddba66557/schema)