Ask a person's wallet for a registered verification query
POST
/v1/wallet-requestsCreates a wallet presentation request on secuveri's swiyu verifier for one of your organization's registered verification queries (Settings, Verification queries), by its scope. secuveri sends exactly the registered DCQL query and verification_purpose, so the wallet shows your registered purpose. Show deeplink as a button on a phone, or open qr_url (a secuveri page with the request as a QR code) on a computer. Needs the sessions:write scope; at most 60 calls a minute.
Send your API key in the x-api-key header.
Request bodyapplication/jsonrequired
- scopestringrequired
Responses
201Created.
- idstringuuid
- scopestring
- statusany
One of
pendingsuccessfailed - deeplinkstring
- qr_urlstringuri
- created_atstringdate-time
- 400The body is not { scope }.
- 401Missing, unknown or expired API key.
- 403The key lacks the scope this call needs, or its IP allowlist refuses the caller.
- 404Your organization has no registered (approved) query with this scope.
- 429More than 60 wallet request calls in a minute.
- 502The verifier could not create the request; retry.
curl -X POST https://api-verify.secuveri.com/v1/wallet-requests \
-H "x-api-key: $SECUVERI_API_KEY" \
-H "content-type: application/json" \
-d '{
"scope": "<scope>"
}'Response · 201
{
"id": "0b8f4f5e-3c2a-4d1b-9e7f-6a5c4b3d2e1f",
"scope": "<scope>",
"status": "pending",
"deeplink": "<deeplink>",
"qr_url": "https://example.com/verified",
"created_at": "2026-10-23T09:12:44.120Z"
}