Skip to main content
POST
/
v1
/
auth
/
register
/
phone
/
send
Send Phone Verification SMS
curl --request POST \
  --url https://api.example.com/v1/auth/register/phone/send \
  --header 'Content-Type: application/json' \
  --data '
{
  "phoneCountryCode": "<string>",
  "phoneNumber": "<string>",
  "contactVerificationId": "<string>"
}
'

​
Overview

Send a verification code via SMS to the user’s phone number. This is typically the second step in the registration onboarding flow after email verification. The user will receive a 6-digit code via SMS that must be verified in the next step.

​
Request

​
Body

​
phoneCountryCode
string
required
Phone country calling codeFormat: Include + prefixExample: +44
​
phoneNumber
string
required
Phone number without country codeExample: 7400846282
​
contactVerificationId
string
required
Verification ID from email send stepExample: US_100a99cf-f4d3-4fa1-9be9-2e9828b20ebb

​
Response

{
  "success": true
}

​
Code Examples

const response = await fetch('https://dev.api.baanx.com/v1/auth/register/phone/send', {
  method: 'POST',
  headers: {
    'x-client-key': 'your-client-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    phoneCountryCode: '+44',
    phoneNumber: '7400846282',
    contactVerificationId: sessionStorage.getItem('contactVerificationId')
  })
});

console.log('SMS verification code sent');

​
Next Steps

Verify Phone Code

Verify the SMS code to confirm phone number