---
title: "Gets a reservation by its ID."
method: GET
path: "/availablePhoneNumbers/reservations/{reservationId}"
tags: ["Browse, reserve and purchase available phone numbers"]
---

# Gets a reservation by its ID.

`GET /availablePhoneNumbers/reservations/{reservationId}`

Retrieves the reservation with the given ID, including all of the phone numbers associated with it.

## Path parameters

- `reservationId` string, uuid, required

## Query parameters

- `api-version` string, required

## Response `200`

Successfully retrieved the reservation.

- PhoneNumbersReservation — Represents a reservation for phone numbers. A reservation is a temporary hold on phone numbers that can later be purchased. The reservation has a limited lifetime after which the phone numbers are released if not purchased. Reservations older than 1 month are automatically deleted.
  - `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'.

## 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/:reservationId/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)