G-g-core
Reservations

List reservations

Changed on

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

get/cloud/v2/reservations

Request

  • Base URL
    https://api.gcore.com
  • URL
    https://api.gcore.com/cloud/v2/reservations
  • Auth
    HTTP apikey

Query parameters

time_fromstring date-time required

Start of the reservation period (ISO 8601). The period must not exceed 31 days. The API returns monthly pricing for this period.

Example:2025-01-01T00:00:00Z
time_tostring date-time required

End of the reservation period (ISO 8601). The period must not exceed 31 days. The API returns monthly pricing for this period.

Example:2025-02-01T00:00:00Z
metric_namestring

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

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"
    }
  ]
}

Changes

  • a2b772345f3aRevision changes
    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • 40c042699d5bRevision changes
    • breaking

      the query request parameter time_from became required

    • breaking

      the query request parameter time_to became required

    • warning

      deleted the query request parameter show_inactive