---
title: "POST /phone-number-orders"
method: POST
path: "/phone-number-orders"
---

# POST /phone-number-orders

`POST /phone-number-orders`

Creates an order for phone numbers to be provisioned. For numbers outside the U.S., you must use the Amazon Chime SDK SIP media application dial-in product type.

## Request body

- object
  - `ProductType` 'VoiceConnector' | 'SipMediaApplicationDialIn', required — The phone number product type.
  - `E164PhoneNumbers` E164PhoneNumber[], required — List of phone numbers, in E.164 format.
  - `Name` string, password — Specifies the name assigned to one or more phone numbers.

## Response `201`

Success

- CreatePhoneNumberOrderResponse
  - `PhoneNumberOrder` object — The phone number order details.
    - `PhoneNumberOrderId` string — The ID of the phone order.
    - `ProductType` 'VoiceConnector' | 'SipMediaApplicationDialIn' — The phone number order product type.
    - `Status` 'Processing' | 'Successful' | 'Failed' | 'Partial' | 'PendingDocuments' | 'Submitted' | 'FOC' | 'ChangeRequested' | 'Exception' | 'CancelRequested' | 'Cancelled' — The status of the phone number order.
    - `OrderType` 'New' | 'Porting' — The type of phone number being ordered, local or toll-free.
    - `OrderedPhoneNumbers` OrderedPhoneNumber[] — The ordered phone number details, such as the phone number in E.164 format and the phone number status.
      - `E164PhoneNumber` string, password — The phone number, in E.164 format.
      - `Status` 'Processing' | 'Acquired' | 'Failed' — The phone number status.
    - `CreatedTimestamp` string, date-time — The phone number order creation time stamp, in ISO 8601 format.
    - `UpdatedTimestamp` string, date-time — The updated phone number order time stamp, in ISO 8601 format.
    - `FocDate` string, date-time — The Firm Order Commitment (FOC) date for phone number porting orders. This field is null if a phone number order is not a porting order.

## Other responses

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

---

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