Skip to Content
Zero-Knowledge Verification (v2)

Verify MFA Zero-Knowledge Proof (v2)

View Markdown (.md)
POST
/api/v2/public/mfa/verify

Performs constant-time zero-knowledge proof verification (codeProof) against the issued challenge nonce. On successful verification, returns a cryptographically signed verificationToken proof token for subsequent authenticated actions and burns the challenge nonce.

Authorization

headerX-Api-Key<token>

SMS Pro API Key (sk_live_... or sk_test_...)

Request Body

application/json
  1. body
challengeId*string
codeProof*string

Zero-Knowledge challenge proof: hex(sha256(challengeNonce.trim().toLowerCase() + ':' + code.trim().toLowerCase()))

Response Body

Challenge verification outcome with proof token

application/json
  1. response
status?string
data?
Example Request
curl -X POST 'https://api.smspro.com/api/v2/public/mfa/verify' \  -H 'Content-Type: application/json' \  -d '{  "challengeId": "string",  "codeProof": "string"}'
Example Response
{  "status": "string",  "data": {    "challengeId": "string",    "verified": true,    "status": "VERIFIED",    "verificationToken": "string",    "verifiedAt": "2019-08-24T14:15:22Z",    "attemptsRemaining": 0,    "message": "string"  }}