---
title: "POST /phone-numbers#operation=batch-delete"
method: POST
path: "/phone-numbers#operation=batch-delete"
---

# POST /phone-numbers#operation=batch-delete

`POST /phone-numbers#operation=batch-delete`

Moves phone numbers into the **Deletion queue**. Phone numbers must be disassociated from any users or Amazon Chime Voice Connectors before they can be deleted.

Phone numbers remain in the **Deletion queue** for 7 days before they are deleted permanently.

## Query parameters

- `operation` 'batch-delete', required

## Request body

- object
  - `PhoneNumberIds` String[], required — List of phone number IDs.

## Response `200`

Success

- BatchDeletePhoneNumberResponse
  - `PhoneNumberErrors` PhoneNumberError[] — If the action fails for one or more of the phone numbers in the request, a list of the phone numbers is returned, along with error codes and error messages.
    - `PhoneNumberId` string — The phone number ID for which the action failed.
    - `ErrorCode` 'BadRequest' | 'Conflict' | 'Forbidden' | 'NotFound' | 'PreconditionFailed' | 'ResourceLimitExceeded' | 'ServiceFailure' | 'AccessDenied' | 'ServiceUnavailable' | 'Throttled' | 'Throttling' | 'Unauthorized' | 'Unprocessable' | 'VoiceConnectorGroupAssociationsExist' | 'PhoneNumberAssociationsExist' — The error code.
    - `ErrorMessage` string — The error message.

## Other responses

- `480` — UnauthorizedClientException
- `481` — NotFoundException
- `482` — ForbiddenException
- `483` — BadRequestException
- `484` — ThrottledClientException
- `485` — ServiceUnavailableException
- `486` — ServiceFailureException

---

[API](https://skmtc.net/aws/apis/chime.md) · [All operations](https://skmtc.net/aws/apis/chime/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/chime/versions/40da18840201/schema)