Creates 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 ofpendingsuccessfailed

    • 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"
}