GET
/
cloud
/
v1
/
reservations
Python
import os
from gcore import Gcore

client = Gcore(
    api_key=os.environ.get("GCORE_API_KEY"),  # This is the default and can be omitted
)
page = client.cloud.billing_reservations.list()
page = page.results[0]
print(page.id)
{
  "count": 1,
  "results": [
    {
      "active_from": "2024-12-02",
      "active_to": "2025-12-02",
      "activity_period": "month",
      "activity_period_length": 12,
      "amount_prices": {
        "commit_price_per_month": "1302.45570000",
        "commit_price_per_unit": "1.75061250",
        "commit_price_total": "15629.46840000",
        "currency_code": "EUR",
        "overcommit_price_per_month": "3060.60768000",
        "overcommit_price_per_unit": "4.11372000",
        "overcommit_price_total": "36727.29216000"
      },
      "billing_plan_id": 1114,
      "created_at": "2024-12-02T11:53:33.127371",
      "error": null,
      "eta": "2025-11-01",
      "id": 10218,
      "is_expiration_message_visible": true,
      "name": "Test_name_TestReservation_1733140407.738675",
      "next_statuses": [
        "APPROVED",
        "REJECTED"
      ],
      "region_id": 4,
      "region_name": "LUX-4",
      "remind_expiration_message": null,
      "resources": [
        {
          "activity_period": "month",
          "activity_period_length": 12,
          "billing_plan_item_id": 2584252,
          "commit_price_per_month": "434.15190000",
          "commit_price_per_unit": "0.58353750",
          "commit_price_total": "5209.82280000",
          "cpu": "2xIntel Xeon 8468",
          "disk": "8 x 3.84 TB NVMe",
          "overcommit_billing_plan_item_id": 2585397,
          "overcommit_price_per_month": "1020.20256000",
          "overcommit_price_per_unit": "1.37124000",
          "overcommit_price_total": "12242.43072000",
          "ram": "2TB RAM",
          "resource_count": 3,
          "resource_name": "bm0-infrastructure-small-fake_min",
          "resource_type": "flavor",
          "unit_name": "H",
          "unit_size_month": "744.00000000",
          "unit_size_total": "8928.00000000"
        }
      ],
      "status": "CREATED",
      "user_status": "CREATED"
    }
  ]
}

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

​
activated_from
string

Lower bound, starting from what date the reservation was/will be activated

​
activated_to
string

High bound, before what date the reservation was/will be activated

​
created_from
string

Lower bound the filter, showing result(s) equal to or greater than date the reservation was created

​
created_to
string

High bound the filter, showing result(s) equal to or less date the reservation was created

​
deactivated_from
string

Lower bound, starting from what date the reservation was/will be deactivated

​
deactivated_to
string

High bound, before what date the reservation was/will be deactivated

​
limit
integer
default:10

Limit of reservation list page

Required range: x >= 1
​
metric_name
string

Name from billing features for specific resource

​
offset
integer
default:0

Offset in reservation list

Required range: x >= 0
​
order_by
enum<string>

Order by field and direction.

Available options:
active_from.asc,
active_from.desc,
active_to.asc,
active_to.desc,
created_at.asc,
created_at.desc
​
region_id
integer

Region for reservation

​
status
enum<string>[]

Field for fixed a status by reservation workflow

Response

200 - application/json

OK

The response is of type object.