Skip to main content
GET
/
cloud
/
v2
/
reservations
List reservations
curl --request GET \
  --url https://api.gcore.com/cloud/v2/reservations \
  --header 'Authorization: <api-key>'
{
  "count": 1,
  "results": [
    {
      "active_billing_plan_id": 207114,
      "active_overcommit": {
        "active_from": "2025-04-03T00:00:00",
        "plan_item_id": 666,
        "price_per_month": "236.63366400",
        "price_per_unit": "0.31805600",
        "price_total": "2839.60396800",
        "subscription_id": 12344
      },
      "commit": {
        "active_from": "2025-04-03T00:00:00",
        "active_to": "2026-04-03T00:00:00",
        "price_per_month": "224.80198100",
        "price_per_unit": "0.30215320",
        "price_total": "2697.62377200",
        "subscription_id": 12345
      },
      "hardware_info": {
        "cpu": "2xIntel Xeon 8468",
        "disk": "8 x 3.84 TB NVMe",
        "ram": "2TB RAM"
      },
      "region_name": "LUX-4",
      "resource_count": 1,
      "resource_name": "bm1-hf-medium",
      "unit_name": "H",
      "unit_size_month": "744.00000000",
      "unit_size_total": "8928.00000000"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Query Parameters

​
metric_name
string

Metric name for the resource (e.g., 'bm1-hf-medium_min')

​
order_by
enum<string>
default:active_from.desc

Order by field and direction.

Available options:
active_from.asc,
active_from.desc,
active_to.asc,
active_to.desc
Examples:

"active_from.asc"

"active_to.asc"

​
region_id
integer

Region for reservation

​
show_inactive
boolean
default:true
deprecated

Include inactive commits in the response. Only applies when no period is given; ignored when 'time_from'/'time_to' are supplied, since the period defines the window.

​
time_from
string<date-time>

Start of the reservation period (ISO 8601). Must be supplied together with 'time_to'. When both are given, period-matched monthly pricing is returned and the period must be at most one month (31 days). When both are omitted, current pricing is returned.

Example:

"2025-01-01T00:00:00Z"

​
time_to
string<date-time>

End of the reservation period (ISO 8601). Must be supplied together with 'time_from'. When both are given, period-matched monthly pricing is returned and the period must be at most one month (31 days). When both are omitted, current pricing is returned.

Example:

"2025-02-01T00:00:00Z"

Response

200 - application/json

OK

​
count
integer
required

Number of objects

Required range: x >= 0
Example:

1

​
results
BillingReservationV2ItemResponseSerializer · object[]
required

Objects