---
title: "phoneVerification"
method: POST
path: "/onboarding/phoneVerification"
tags: ["onboarding"]
---

# phoneVerification

`POST /onboarding/phoneVerification`

## Request

- Base URL: `https://docs.wowinvoice.io`
- URL: `https://docs.wowinvoice.io/onboarding/phoneVerification`
- Auth: API key in header `authorization`

Starts a verified phone claim or change. A verified phone can sign in to either a legacy or phone-first account; legacy accounts retain email/password sign-in as well.

## Request body

- object
  - `country_code` string
  - `country_iso` string
  - `phone` string
  - `device_id` string

## Response `200`

Standard successful response envelope.

- SuccessEnvelope
  - `status` 'success', required
  - `statusCode` integer, required
  - `message` string, required
  - `data` object, required
  - `error` unknown, required

## Other responses

- `400`: Standard API error envelope.
- `401`: Standard API error envelope.
- `403`: Standard API error envelope.
- `409`: Standard API error envelope.
- `422`: Standard API error envelope.

## Changes

- **2026-10-14** `303b7b41cadd`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wowinvoice/apis/wow-invoice-internal-api/changes/onboarding/phoneVerification/post.md)

---

[API](https://skmtc.dev/wowinvoice/apis/wow-invoice-internal-api.md) - [All operations](https://skmtc.dev/wowinvoice/apis/wow-invoice-internal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wowinvoice/apis/wow-invoice-internal-api/revisions/303b7b41cadd?raw)