GET
/
cloud
/
v1
/
reservations
/
{reservation_id}
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
)
billing_reservation = client.cloud.billing_reservations.get(
    0,
)
print(billing_reservation.id)
{
  "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

Path Parameters

​
reservation_id
integer
required

ID of the reservation

Response

200 - application/json

OK

​
active_from
string<date>
required

Reservation active from date

​
active_to
string<date>
required

Reservation active to date

​
activity_period
string
required

Name of the billing period, e.g month

​
activity_period_length
integer
required

Length of the full reservation period by activity_period

​
amount_prices
object
required

Reservation amount prices

​
billing_plan_id
integer
required

Billing plan id

​
created_at
string<date-time>
required

Reservation creation date

​
error
string | null
required

Error message if any occured during reservation

​
eta
string<date> | null
required

ETA delivery if bare metal out of stock. Value None means that bare metal in stock.

​
id
integer
required

Reservation id

​
is_expiration_message_visible
boolean
required

Hide or show expiration message to customer.

Examples:

true

​
name
string
required

Reservation name

​
next_statuses
string[]
required

List of possible next reservation statuses

​
region_id
integer
required

Region id

​
region_name
string
required

Region name

​
remind_expiration_message
string<date> | null
required

The date when show expiration date to customer

Examples:

"2024-01-01"

​
resources
BillingReservationResourceSerializer · object[]
required

List of reservation resources

​
status
string
required

Reservation status

Examples:

"ACTIVATED"

​
user_status
string
required

User status

Examples:

"ACTIVATED"