5f4eb30ac29a

latestOpenAPI 3.1.02026-08-1057178174.9 KB
authentication

Verify a phone number

Submits the SMS code from Register a phone number. On success the account is created, an API key is issued, and a first phone number is provisioned — the response is identical to the sign-in outcome of Verify a sign-up code. The API key is returned only once — store it immediately.

If provisioning fails you receive a 502 and may retry this call with the same registrationId; the phone number stays verified, so no new code is needed.

Note that phoneNumber in the response is the Dial number provisioned for the account, not the number you just verified.

post/api/v1/auth/verify-number

Request body

registrationIdstring required
codestring required

The 6-digit code from the SMS.

Response

Verified, account created.

apiKeystring nullable

Your API key. Shown once, when the account is created.

accountIdstring
createdboolean

True when this call created the account.

phoneNumberstring nullable

The Dial number provisioned for the account, if any. This is not the phone number used to register.

phoneNumberIdstring nullable
messagestring