---
title: "List reservations"
method: GET
path: "/cloud/v2/reservations"
tags: ["Reservations"]
---

# List reservations

`GET /cloud/v2/reservations`

Get a list of billing reservations along with detailed information
on resource configurations and associated pricing.

## Query parameters

- `metric_name` string — Metric name for the resource (e.g., 'bm1-hf-medium_min')
- `order_by` 'active_from.asc' | 'active_from.desc' | 'active_to.asc' | 'active_to.desc'
- `region_id` integer — Region for reservation
- `show_inactive` boolean — Include inactive commits in the response

## Response `200`

OK

- BillingReservationV2CollectionResponseSerializer
  - `count` integer, required — Number of objects
  - `results` BillingReservationV2ItemResponseSerializer[], required — Objects
    - `active_billing_plan_id` integer, required — Active billing plan ID
    - `active_overcommit` BillingReservationV2OvercommitSerializer, required
      - `active_from` string, date-time, required — Billing subscription active from date
      - `plan_item_id` integer, nullable, required — Billing plan item ID
      - `price_per_month` string, required — Price per month
      - `price_per_unit` string, required — Price per unit (hourly)
      - `price_total` string, required — Total price for the reservation period
      - `subscription_id` integer, nullable, required — Billing subscription ID for overcommit
    - `commit` BillingReservationV2CommitSerializer, required
      - `active_from` string, date-time, required — Billing subscription active from date
      - `active_to` string, date-time, nullable, required — Billing subscription active to date
      - `price_per_month` string, required — Price per month, per one resource
      - `price_per_unit` string, required — Price per unit, per one resource (hourly)
      - `price_total` string, required — Total price for the reservation period for the full reserved amount
      - `subscription_id` integer, nullable, required — Billing subscription ID for commit
    - `hardware_info` BillingReservationV2HardwareInfoSerializer, required
      - `cpu` string, nullable, required — CPU specification
      - `disk` string, nullable, required — Disk specification
      - `ram` string, nullable, required — RAM specification
    - `region_name` string, required — Region name
    - `resource_count` integer, required — Number of reserved resource items
    - `resource_name` string, required — Resource name
    - `unit_name` string, required — Unit name (e.g., 'H' for hours)
    - `unit_size_month` string, required — Unit size per month (e.g., 744 hours)
    - `unit_size_total` string, required — Unit size month multiplied by count of resources in the reservation

---

[API](https://skmtc.net/g-core/apis/gcore-openapi.md) · [All operations](https://skmtc.net/g-core/apis/gcore-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/g-core/gcore-openapi/revisions/09e652815095/schema)