---
title: "Verify a phone number"
method: POST
path: "/api/v1/auth/verify-number"
tags: ["authentication"]
---

# Verify a phone number

`POST /api/v1/auth/verify-number`

Submits the SMS code from [Register a phone number](#operation/registerNumber).
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](#operation/verifySignup). **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.

## Request body

- object
  - `registrationId` string, required
  - `code` string, required — The 6-digit code from the SMS.

## Response `200`

Verified, account created.

- AuthenticatedAccount — A completed sign-in or registration. Returned by both [Verify a sign-up code](#operation/verifySignup) (when signing in) and [Verify a phone number](#operation/verifyNumber) (when registering).
  - `apiKey` string, nullable — Your API key. Shown once, when the account is created.
  - `accountId` string
  - `created` boolean — True when this call created the account.
  - `phoneNumber` string, nullable — The Dial number provisioned for the account, if any. This is not the phone number used to register.
  - `phoneNumberId` string, nullable
  - `message` string

## Other responses

- `400` — The request body failed validation.
- `401` — The code is wrong, expired, or already used. Request a new one with [Register a phone number](#operation/registerNumber).
- `409` — The request conflicts with the current state. During registration this means the registration is unknown or already complete, its email is not verified yet, no phone number has been registered against it, or the phone number is already registered to another account.
- `429` — Too many attempts. Wait before retrying. During registration this also covers the cap on verification codes sent to a single phone number.

---

[API](https://skmtc.net/getdial/apis/rest-api.md) · [All operations](https://skmtc.net/getdial/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getdial/rest-api/revisions/5f4eb30ac29a/schema)