Skip to main content
POST
/
me
/
phone-numbers
/
{id}
/
attempt-verification
Verify Phone Number with OTP
curl --request POST \
  --url https://{deploymentHost}/me/phone-numbers/{id}/attempt-verification \
  --header 'Content-Type: application/json' \
  --data '{
  "code": "123456"
}'
{
"status": 200,
"message": "",
"data": {
"verified": true,
"phone_number": {
"id": "phone_987654321",
"phone_number": "+1234567890",
"verified": true,
"primary": false,
"created_at": "2024-01-10T12:00:00Z",
"verified_at": "2024-01-10T12:05:00Z"
}
},
"session": {
"signin_attempts": [],
"signins": [
{
"id": "signin_987654321",
"user_id": "user_456789123",
"created_at": "2024-01-01T12:00:00Z"
}
],
"signup_attempts": [],
"active_signin": {
"id": "signin_987654321",
"user_id": "user_456789123",
"created_at": "2024-01-01T12:00:00Z"
}
},
"errors": []
}

Authorizations

__session
string
cookie
required

Session cookie authentication for production deployments. The session token is automatically set as an HTTP-only, secure cookie.

Path Parameters

id
string
required

Phone number ID to verify

Body

application/json
code
string
required

6-digit OTP code received via SMS

Response

Phone number verified successfully

status
integer
required

HTTP status code

message
string
required

Response message (empty for success)

data
any
required

Response data (can be any type)

session
object
required
errors
object[]
required

Array of error objects (empty for success)