v32

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

Cost Reports

Get monthly cost report totals (commits and pay-as-you-go)

Retrieve a detailed cost report totals for a specified month, which includes both commit and pay-as-you-go (overcommit) prices. Additionally, it provides the spent billing units (e.g., hours or GB) for resources. The "time_to" parameter represents all days in the specified month.

Data from the past hour may not reflect the full set of statistics. For the most complete and accurate results, we recommend accessing the data at least one hour after the relevant time period. Updates are generally available within a 24-hour window, though timing can vary. Scheduled maintenance or other exceptions may occasionally cause delays beyond 24 hours.

post/cloud/v1/reservation_cost_report/totals

Request body

regionsinteger[]

List of region IDs.

response_format'csv_totals' | 'json'

Response format for Reservation Cost Report

roundingboolean

Round cost values to 5 decimal places. When false, returns full precision.

time_fromstring date-time

Deprecated. Use year_month instead. Beginning of the period: YYYY-mm

time_tostring date-time

Deprecated. Use year_month instead. End of the period: YYYY-mm

typesPrebillingResourceTypes[]

List of resource types to be filtered in the report.

year_monthstring

Year and month in the format YYYY-MM

Example request

{
  "regions": [
    1,
    2,
    3
  ],
  "schema_filter": {
    "values": [
      "10"
    ]
  },
  "tags": {
    "conditions": [
      {
        "key": "os_version",
        "strict": true,
        "value": "22.04"
      }
    ]
  },
  "types": [
    "egress_traffic",
    "instance"
  ],
  "year_month": "2024-08"
}

Response

countinteger required

Total count of the totals

price_status'error' | 'hide' | 'show' required

Example response

{
  "count": 1,
  "results": [
    {
      "billing_feature_name": "AI Infrastructure: bm3-ai-1xlarge-h100-80-8 (2 x Intel Xeon 8480+, 2TB RAM, 8x3.84 TB NVMe, 8x Nvidia H100, IB 3.2 Tbit/s, 2x100Gbit/s Ethernet)  Luxembourg-2 - PAYG",
      "billing_metric_name": "bm3-ai-1xlarge-h100-80-8_min",
      "billing_value": 1000,
      "billing_value_unit": "minutes",
      "cost": 1000,
      "currency": "EUR",
      "flavor": "bm3-ai-1xlarge-h100-80-8",
      "region": 76,
      "region_id": 76
    }
  ]
}