Create a presentation request

Overview

Once you’ve picked a preset (see Browse presentation presets), create the request by passing its id. The response carries the URIs you’ll deliver to the user. This guide uses didx:basic-identity-request, which asks for firstName and lastName from a basic identity credential, accepting issuers such as the South African Reserve Bank and the Department of Home Affairs.

Need to verify something no preset covers? See Custom presentation template. For everything else, use a preset.

Endpoint

POST https://test.didxtech.com/me-creds/api/v1/presentations/request

Request

curl -X POST "https://test.didxtech.com/me-creds/api/v1/presentations/request" \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "presetId": "didx:basic-identity-request"
  }'

Request body

Field	Type	Description
`presetId`	string	The id of the preset you’re verifying against (e.g. `didx:basic-identity-request`). Browse available presets at `GET /presets/presentations`.

Pass either presetId or presentationTemplateId, not both. Most integrations only ever use presetId. The template path is for custom presentation shapes.

Response

HTTP 200 OK

{
  "data": {
    "id": "cmbhsgi6c00cls60120oyb8tl",
    "createdAt": "2025-06-04T10:12:20.101Z",
    "updatedAt": "2025-06-04T10:12:20.101Z",
    "status": "requested",
    "error": null,
    "expiresAt": "2025-07-04T10:12:20.088Z",
    "authorizationRequestUri": "https://test.didxtech.com/invitation?request_uri=...",
    "authorizationRequestQrUri": "https://test.didxtech.com/invitation?request_uri=...&qr=true"
  }
}

Key response fields

Field	Description
`id`	Unique presentation request identifier. Save this for later steps
`status`	`requested` initially. Transitions to `verified` once the user responds
`authorizationRequestUri`	Link the user can paste directly into their wallet
`authorizationRequestQrUri`	QR-optimised version for scanning with a wallet app
`expiresAt`	Request expires after 30 days

Deliver the request

Save the id so you can read the user’s response later, then deliver the request to the user. Two options:

By email, username, or other identifier: Deliver via identifier.
As a QR code or deeplink rendered in your own UI: Deliver out of band.

Overview

User Onboarding

Issuance

Verification

Webhooks

Custom Templates (advanced)

Errors

Overview

Endpoint

Request

Request body

Response

Key response fields

Deliver the request

​Overview

​Endpoint

​Request

​Request body

​Response

​Key response fields

​Deliver the request

Overview

Endpoint

Request

Request body

Response

Key response fields

Deliver the request