Overview
A presentation request is a single-use instance of a presentation template. It generates authorization URIs that you present to the user, allowing them to share their credentials with your application.
Endpoint
POST https://test.didxtech.com/me-creds/api/presentations/request
Request
curl -X POST "https://test.didxtech.com/me-creds/api/presentations/request" \
-H "Authorization: Bearer <access_token>" \
-H "Content-Type: application/json" \
-d '{
"presentationTemplateId": "cm2ytsdid009u4ke3t30aiuvc"
}'
Request Body
| Field | Type | Description |
|---|
presentationTemplateId | string | The id from the presentation template created in Step 1 |
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,
"presentationTemplateId": "cma2nw2vd00sos601irn14wt1",
"credentials": [
{
"isValid": true,
"name": "Identity",
"type": "https://metadata.paradym.id/types/pHXnPey2Uu-identity",
"attributes": {
"studentId": "STU2024001234",
"fullName": "John Doe",
"enrollmentDate": "2024-09-01",
"degreeProgram": "Computer Science"
},
"issues": []
}
],
"expiresAt": "2025-07-04T10:12:20.088Z",
"authorizationRequestUri": "https://paradym.id/invitation?request_uri=https%3A%2F%2Fparadym.id%2Finvitation%2F421b518d-ad91-4802-ab25-3a83c9f7f44e%2Fauthorization-requests%2F92c2b88e-9a3d-4ca4-a33f-8687588d0f6b%3Fraw%3Dtrue&client_id=did%3Aweb%3Ametadata.paradym.id%3A3c9d79ef-6aca-4f3e-b2ab-1f2933b7fe90",
"authorizationRequestQrUri": "https://paradym.id/invitation?request_uri=https%3A%2F%2Fparadym.id%2Finvitation%2F421b518d-ad91-4802-ab25-3a83c9f7f44e%2Fauthorization-requests%2F92c2b88e-9a3d-4ca4-a33f-8687588d0f6b%3Fraw%3Dtrue&qr=true"
}
}
Key Response Fields
| Field | Description |
|---|
id | Unique presentation request identifier — save this for Step 4 |
status | requested initially; transitions to verified once the user presents |
authorizationRequestUri | Link the user can paste directly into their wallet |
authorizationRequestQrUri | QR-optimized version for scanning with a wallet app |
expiresAt | Request expires after 30 days |
Save the id and authorizationRequestQrUri from the response — you’ll need them in the next steps.
