Signed attestation of a secuveri wallet face check, for an OpenID4VP verifier
/v1/face-check/attestationPublic: no API key. The secuveri Wallet binds its face check (liveness selfie matched against the portrait of the holder's secuveri credential) to your presentation request. Call this with your request object's nonce and your client_id once you received the presentation. Returns a compact ES256 JWT with typ secuveri-face-check+jwt, signed with a key from /.well-known/jwks.json: aud is your client_id, nonce your nonce, face_check.verdict APPROVED, face_check.portrait_sha256 the SHA-256 of the reference portrait, which must equal the portrait_sha256 claim of the secuveri credential presented to you. Valid 5 minutes. Single use: the first successful call spends it. Only an approved face check yields a JWT.
Public: no API key needed.
Query parameters
- noncestring≤ 512 charsrequired
The nonce of your OpenID4VP request object.
- client_idstring≤ 512 charsrequired
Your client_id exactly as in the request object, with its prefix (e.g. decentralized_identifier:did:…).
Responses
200The signed attestation.
- statusstringalways "OK"required
- attestationstringrequired
Compact ES256 JWT (typ secuveri-face-check+jwt).
202The face check is still running. Ask again in a few seconds.
- statusstringalways "PENDING"
- 400nonce or client_id missing.
- 404No face check is bound to this nonce and client_id: the wallet did not run one for your request.
- 409The face check finished without approval. No attestation exists.
- 410Already fetched.
- 429At most 120 calls per minute per IP address.
- 503Signing is not configured; nothing was spent.
curl https://api-verify.secuveri.com/v1/face-check/attestation?nonce=%3Cnonce%3E&client_id=%3Cclient%20id%3E{
"status": "OK",
"attestation": "<attestation>"
}