---
title: "Lists all reservations."
method: GET
path: "/availablePhoneNumbers/reservations"
tags: ["Browse, reserve and purchase available phone numbers"]
---

# Lists all reservations.

`GET /availablePhoneNumbers/reservations`

Retrieves a paginated list of all phone number reservations. Note that the reservations will not be populated with the phone numbers associated with them.

## Query parameters

- `api-version` string, required
- `maxPageSize` integer

## Response `200`

A collection of Phone Number Reservations, and an optional link to the next page of results.

- PhoneNumbersReservations — Represents a list of phone numbers reservations. Note that the phone numbers from each reservation are not included.
  - `reservations` PhoneNumbersReservation[], required — Represents a list of phone numbers reservations. Note that the phone numbers from each reservation are not included.
    - `id` string, uuid — The id of the reservation.
    - `expiresAt` string, date-time — The time at which the reservation will expire. If a reservation is not purchased before this time, all of the reserved phone numbers will be released and made available for others to purchase.
    - `phoneNumbers` object — A dictionary containing the reservation phone numbers. The key is the ID of the phone number (digits only) and values are AvailablePhoneNumber objects. Not populated when retrieving PhoneNumbersReservation collections.
    - `status` 'active' | 'submitted' | 'completed' | 'expired' — Represents the status of the reservation. Possible values include: 'active', 'submitted', 'completed', 'expired'.
  - `nextLink` string — Represents the URL link to the next page of phone number results.

## Other responses

- `default` — Failure

## Changes

- **2021-05-19** (2021-03-07) `5c6abf2b2252` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/azure/apis/communication-phonenumbers/changes/availablePhoneNumbers/reservations/get.md)

---

[API](https://skmtc.dev/azure/apis/communication-phonenumbers.md) · [All operations](https://skmtc.dev/azure/apis/communication-phonenumbers/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/communication-phonenumbers/revisions/6e81b3741aa7/schema)