---
title: "Preview Phone Number Deletion"
method: GET
path: "/core/phone-numbers/{phone_number}/deletion-preview"
tags: ["Phone Numbers"]
---

# Preview Phone Number Deletion

`GET /core/phone-numbers/{phone_number}/deletion-preview`

## Request

- Base URL: `https://api.anyreach.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.anyreach.ai/core/phone-numbers/{phone_number}/deletion-preview`
- Auth: HTTP bearer

Describe what deleting this phone number will do. A number on the
shared Anyreach account is released at the provider on delete, so the
caller can warn about that before confirming.

## Path parameters

- `phone_number` string, required

## Headers

- `x-anyreach-org` string, nullable: Organization ID for user PATs (pat_ prefix tokens)

## Response `200`

Successful Response

- PhoneNumberDeletionPreview: What deleting a phone number will actually do, so callers can confirm with the right wording before the number is gone.
  - `phone_number` string, required
  - `managed_account_scope` 'shared' | 'organization', nullable
  - `provider` 'twilio': Managed account types.
  - `will_release` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/anyreach/apis/anyreach-api.md) - [All operations](https://skmtc.dev/anyreach/apis/anyreach-api/llms.txt) - [OpenAPI document](https://skmtc.dev/anyreach/apis/anyreach-api/revisions/2eddf40c8c93?raw)