---
title: "GET /v1/reservations"
method: GET
path: "/v1/reservations"
---

# GET /v1/reservations

`GET /v1/reservations`

Displays a list of all reservations that have been purchased by this account in the current AWS Region. This list includes all reservations in all states (such as active and expired).

## Query parameters

- `maxResults` integer
- `nextToken` string
- `MaxResults` string
- `NextToken` string

## Response `200`

Success

- ListReservationsResponse
  - `NextToken` string — The token that identifies which batch of results that you want to see. For example, you submit a ListReservations request with MaxResults set at 5. The service returns the first batch of results (up to 5) and a NextToken value. To see the next batch of results, you can submit the ListReservations request a second time and specify the NextToken value.
  - `Reservations` Reservation[] — A list of all reservations that have been purchased by this account in the current AWS Region.
    - `CurrencyCode` string, required — The type of currency that is used for billing. The currencyCode used for your reservation is US dollars.
    - `Duration` integer, required — The length of time that this reservation is active. MediaConnect defines this value in the offering.
    - `DurationUnits` 'MONTHS', required — The unit of measurement for the duration of the reservation. MediaConnect defines this value in the offering.
    - `End` string, required — The day and time that this reservation expires. This value is calculated based on the start date and time that you set and the offering's duration.
    - `OfferingArn` string, required — The Amazon Resource Name (ARN) that MediaConnect assigns to the offering.
    - `OfferingDescription` string, required — A description of the offering. MediaConnect defines this value in the offering.
    - `PricePerUnit` string, required — The cost of a single unit. This value, in combination with priceUnits, makes up the rate. MediaConnect defines this value in the offering.
    - `PriceUnits` 'HOURLY', required — The unit of measurement that is used for billing. This value, in combination with pricePerUnit, makes up the rate. MediaConnect defines this value in the offering.
    - `ReservationArn` string, required — The Amazon Resource Name (ARN) that MediaConnect assigns to the reservation when you purchase an offering.
    - `ReservationName` string, required — The name that you assigned to the reservation when you purchased the offering.
    - `ReservationState` 'ACTIVE' | 'EXPIRED' | 'PROCESSING' | 'CANCELED', required — The status of your reservation.
    - `ResourceSpecification` object, required — A definition of the amount of outbound bandwidth that you would be reserving if you purchase the offering. MediaConnect defines the values that make up the resourceSpecification in the offering.
      - `ReservedBitrate` integer — The amount of outbound bandwidth that is discounted in the offering.
      - `ResourceType` 'Mbps_Outbound_Bandwidth', required — The type of resource and the unit that is being billed for.
    - `Start` string, required — The day and time that the reservation becomes active. You set this value when you purchase the offering.

## Other responses

- `480` — ServiceUnavailableException
- `481` — TooManyRequestsException
- `482` — BadRequestException
- `483` — InternalServerErrorException

---

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