v32

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

Cost Reports

Get cost report totals (pay-as-you-go only)

Get cost report totals (aggregated costs) for a given period. Requested period should not exceed 31 days.

Note: This report assumes there are no active commit features in the billing plan. If there are active commit features (pre-paid resources) in your plan, use /v1/reservation_cost_report/totals, as the results from this report will not be accurate.

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/cost_report/totals

Request body

enable_last_dayboolean

Expenses for the last specified day are taken into account. As the default, False.

projectsinteger[]

List of project IDs

regionsinteger[]

List of region IDs.

response_format'csv_totals' | 'json'

roundingboolean

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

time_fromstring date-time required

The start date of the report period (ISO 8601). The report starts from the beginning of this day in UTC.

time_tostring date-time required

The end date of the report period (ISO 8601). The report ends just before the beginning of this day in UTC.

typesPrebillingResourceTypes[]

List of resource types to be filtered in the report.

Example request

{
  "projects": [
    16,
    17,
    18,
    19,
    20
  ],
  "regions": [
    1,
    2,
    3
  ],
  "schema_filter": {
    "values": [
      "10"
    ]
  },
  "tags": {
    "conditions": [
      {
        "key": "os_version",
        "strict": true,
        "value": "22.04"
      }
    ]
  },
  "time_from": "2023-01-01T00:00:00Z",
  "time_to": "2023-02-01T00:00:00Z",
  "types": [
    "egress_traffic",
    "instance"
  ]
}

Response

countinteger required

Count of returned 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
    }
  ]
}