---
title: "List the tenant's presentation requests."
method: GET
path: "/v1/presentations/requests"
tags: ["OpenID4VP Verification"]
---

# List the tenant's presentation requests.

`GET /v1/presentations/requests`

List your tenant's OpenID4VP (OpenID for Verifiable Presentations) presentation requests. Use this endpoint to inspect request status, requested claims, and the generated DCQL (Digital Credentials Query Language) query.

## Response `200`

Returns a bare JSON array. Each array element is one presentation request.

- object[]
  - `aud` string — Identifies the verifier audience for the presentation.
  - `created_at` string, date-time — Records when the presentation request was created.
  - `dcql` object — Contains the DCQL (Digital Credentials Query Language) query the wallet evaluates.
    - `credentials` object[] — Lists the credential queries in the presentation request.
      - `claims` object[] — Lists the claim paths the verifier asks the holder to disclose.
        - `path` string[] — Identifies the requested claim path.
      - `format` string — Names the credential format requested by this query.
      - `id` string — Identifies the credential query inside the DCQL (Digital Credentials Query Language) payload.
      - `meta` object — Carries metadata that constrains matching credentials.
        - `vct_values` string[] — Lists accepted VCT (Verifiable Credential Type) values.
  - `nonce` string — Carries the nonce the wallet must bind into the presentation response.
  - `purpose` string — Explains why the verifier requests the presentation.
  - `requested_claims` string[] — Lists the claim names the verifier asks the holder to disclose.
  - `requested_vct` string — Names the requested VCT (Verifiable Credential Type).
  - `status` 'pending' | 'verified' | 'failed' — Shows the current state of the presentation request.
  - `transaction_id` string, uuid — Binds the presentation request to the later verification result.
  - `trusted_iss` string — Returns the trusted issuer value configured for the request.
  - `uuid` string, uuid — Identifies the presentation request.
  - `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`.

---

[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/revisions/e4eddba66557/schema)