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

# removePhoneVerification

`POST /onboarding/removePhoneVerification`

## Request

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

Internal onboarding/removePhoneVerification operation. Authentication requirements are derived from the active route allowlist.

## Request body

- object
  - `password` string, password
  - `device_id` string, required

## Response `200`

Removes the active verified phone. If the account has a verified recovery email, data is { phone_removed: true, account_closed: false }. Otherwise the account is soft-closed and data is { phone_removed: true, account_closed: true }. Active Apple/RevenueCat subscriptions must be cancelled in the store before account closure.

- 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/removePhoneVerification/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)