---
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).

---

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