---
title: "Poll a presentation request (holder + status)"
method: GET
path: "/v1/presentations/{uuid}"
tags: ["OpenID4VP Verification"]
---

# Poll a presentation request (holder + status)

`GET /v1/presentations/{uuid}`

Fetch the holder-facing view of one OpenID4VP (OpenID for Verifiable Presentations) presentation request. You can use it to render the requester, purpose, requested claims, and current request status.

## Path parameters

- `uuid` string, uuid, required

## Response `200`

Returns the public presentation request view for the holder.

- object
  - `uuid` string, uuid — Identifies the presentation request.
  - `transaction_id` string, uuid — Binds the presentation request to the later verification result.
  - `dcql` object — Contains the DCQL (Digital Credentials Query Language) query the wallet evaluates.
    - `credentials` object[] — Lists the credential queries in the presentation request.
      - `id` string — Identifies the credential query inside the DCQL (Digital Credentials Query Language) payload.
      - `format` string — Names the credential format requested by this query.
      - `meta` object — Carries metadata that constrains matching credentials.
        - `vct_values` string[] — Lists accepted VCT (Verifiable Credential Type) values.
      - `claims` object[] — Lists the claim paths the verifier asks the holder to disclose.
        - `path` string[] — Identifies the requested claim path.
  - `requested_vct` string — Names the requested VCT (Verifiable Credential Type).
  - `requested_claims` string[] — Lists the claim names the verifier asks the holder to disclose.
  - `aud` string — Identifies the verifier audience for the presentation.
  - `nonce` string — Carries the nonce the wallet must bind into the presentation response.
  - `purpose` string — Explains why the verifier requests the presentation.
  - `trusted_iss` string — Returns the trusted issuer value configured for the request.
  - `status` 'pending' — Shows the current state of this presentation request.
  - `created_at` string, date-time — Records when the presentation request was created.
  - `requester` object — Describes the relying party shown to the holder.
    - `id` string — Identifies the requester role.
    - `name` string — Shows the requester name to the holder.
    - `did` string — Identifies the requester with a decentralized identifier.
    - `purpose` string — Explains why this requester asks for the presentation.
  - `claims` object[] — Lists the holder-facing claims requested for disclosure.
    - `name` string — Names the requested claim.
    - `label` string — Shows the display label for the claim.
    - `requested` boolean — Indicates whether the verifier requested this claim.
    - `selective_disclosure` boolean — Indicates whether the holder can disclose this claim selectively.

---

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