Skip to Content
Zero-Knowledge Verification (v2)

Initiate MFA Challenge with Nonce (v2)

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

Generates a security challenge and dispatches verification challenge code over configured channels (SMS, WhatsApp, or auto-failover). Returns a 128-bit cryptographic challenge nonce for client-side zero-knowledge proof calculation.

Authorization

headerX-Api-Key<token>

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

Request Body

application/json
  1. body
phoneNumber*string
workflowId?string
action?string
senderId?string

Response Body

MFA challenge initiated with challenge nonce

application/json
  1. response
status?string
data?
Example Request
curl -X POST 'https://api.smspro.com/api/v2/public/mfa/challenge' \  -H 'Content-Type: application/json' \  -d '{  "phoneNumber": "string"}'
Example Response
{  "status": "string",  "data": {    "challengeId": "string",    "status": "string",    "channel": "string",    "maskedPhone": "string",    "attemptsRemaining": 0,    "expiresAt": "2019-08-24T14:15:22Z",    "resendAvailableAt": "2019-08-24T14:15:22Z",    "message": "string",    "challengeNonce": "string",    "proofAlgorithm": "string",    "proofFormat": "string"  }}