---
title: "Create a presentation request (alias of POST /v1/presentations/request)"
method: POST
path: "/v1/presentations/requests"
tags: ["OpenID4VP Verification"]
---

# Create a presentation request (alias of POST /v1/presentations/request)

`POST /v1/presentations/requests`

Create a presentation request (alias of POST /v1/presentations/request).

## Request body

- object
  - `aud` string
  - `purpose` string
  - `requested_claims` string[]
  - `requested_vct` string
  - `relying_party_id` string, uuid — You optionally scope this request to a registered relying party by UUID. When set, the relying party's per-RP trust rules apply on top of the tenant registry.

## Response `201`

Successful response.

- object
  - `aud` string
  - `created_at` string
  - `dcql` object
    - `credentials` object[]
      - `claims` object[]
        - `path` string[]
      - `format` string
      - `id` string
      - `meta` object
        - `vct_values` string[]
  - `nonce` string
  - `purpose` string
  - `requested_claims` string[]
  - `requested_vct` string
  - `status` string
  - `transaction_id` string
  - `trusted_iss` string
  - `uuid` string
  - `relying_party` string, uuid, nullable — You receive the relying party UUID this request is scoped to, or null when it is not scoped to one.
  - `trust_policy` string — You receive the effective trust policy for this request: `tenant` or `custom`.

## Changes

- **2026-07-05** `e4eddba66557` — 3 info
  - added the new optional request property `relying_party_id`
  - added the optional property `relying_party` to the response with the `201` status
  - added the optional property `trust_policy` to the response with the `201` status
- **2026-07-03** `9addd64b04b1` — 2 breaking, 1 info
  - added required request body
  - removed the success response with the status `200`
  - added the success response with the status `201`
- **2026-07-01** `1c34704cfbbb` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/didit-protocol/apis/didit-credentials-api/changes/v1/presentations/requests/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)