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

# phoneLoginVerification

`POST /onboarding/phoneLoginVerification`

## Request

- Base URL: `https://docs.wowinvoice.io`
- URL: `https://docs.wowinvoice.io/onboarding/phoneLoginVerification`
- Auth: none required

Starts the shared phone sign-in/sign-up verification flow. A successful OTP claim signs in the existing verified-phone owner or creates a new phone-first account.

## Request body

- object
  - `country_code` string
  - `country_iso` string
  - `phone` string
  - `device_id` string
  - `platform` 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/phoneLoginVerification/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)