v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-151,1412,2144.5 MB
Reservations

List reservations

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

get/cloud/v2/reservations

Query parameters

metric_namestring

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

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'

Order by field and direction.

region_idinteger

Region for reservation

Region for reservation

show_inactiveboolean

Include inactive commits in the response

Include inactive commits in the response

Response

OK

countinteger required

Number of objects

Example response

{
  "count": 1,
  "results": [
    {
      "active_billing_plan_id": 207114,
      "active_overcommit": {
        "active_from": "2025-04-03T00:00:00Z",
        "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:00Z",
        "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"
    }
  ]
}