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

# GET /phone-number-orders

`GET /phone-number-orders`

Lists the phone number orders for the administrator's Amazon Chime account.

## Query parameters

- `next-token` string
- `max-results` integer
- `MaxResults` string
- `NextToken` string

## Response `200`

Success

- ListPhoneNumberOrdersResponse
  - `PhoneNumberOrders` PhoneNumberOrder[] — The phone number order details.
    - `PhoneNumberOrderId` string — The phone number order ID.
    - `ProductType` 'BusinessCalling' | 'VoiceConnector' | 'SipMediaApplicationDialIn' — The phone number order product type.
    - `Status` 'Processing' | 'Successful' | 'Failed' | 'Partial' — The status of the phone number order.
    - `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.
  - `NextToken` string — The token to use to retrieve the next page of results.

## Other responses

- `480` — UnauthorizedClientException
- `481` — ForbiddenException
- `482` — BadRequestException
- `483` — ThrottledClientException
- `484` — ServiceUnavailableException
- `485` — 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)