Documentation | Reservations › List Reservations

Reservations

reservations

Methods

Create Reservation -> { id, active_from, active_to, 16 more... }

post/v1/reservations

Create reservation

Delete Reservation ->

delete/v1/reservations/{reservation_id}

Delete reservation

List Reservations -> OffsetPage<{ id, active_from, active_to, 16 more... }>

get/v1/reservations

List reservations

Parameters

activated_from: string

Optional

(format: date)

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

activated_to: string

Optional

(format: date)

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

created_from: string

Optional

(format: date-time)

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

created_to: string

Optional

(format: date-time)

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

deactivated_from: string

Optional

(format: date)

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

deactivated_to: string

Optional

(format: date)

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

limit: number

Optional

(minimum: 1)

Limit of reservation list page

metric_name: string

Optional

Name from billing features for specific resource

offset: number

Optional

(minimum: 0)

Offset in reservation list

region_id: number

Optional

Region for reservation

status: Array<

Optional

Field for fixed a status by reservation workflow

"ACTIVATED"

"APPROVED"

"COPIED"

"CREATED"

"EXPIRED"

"REJECTED"

"RESERVED"

"WAITING_FOR_PAYMENT"

Response fields

count: number

(minimum: 0)

Number of objects

results: Array<{ id, active_from, active_to, 16 more... }>

Objects

Request example

curl https://api.gcore.com/cloud/v1/reservations \
    -H "APIKey: $CLOUD_API_API_KEY"

200Example

{
  "count": 1,
  "results": [
    {
      "id": 10218,
      "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": "2019-12-27T18:11:19.117Z",
      "error": null,
      "eta": "2025-11-01",
      "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": "user_status"
    }
  ]
}

List Of Bare Metal Flavors That Are Available For Reservation -> Array<{ activity_period, activity_period_length, architecture, 9 more... }>

get/v1/bm_reservation_flavors/{region_id}

List of bare metal flavors that are available for reservation

Get Specific Reservation -> { id, active_from, active_to, 16 more... }

get/v1/reservations/{reservation_id}

Get specific reservation