Sign in

v32

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

Get usage statistics report

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/usage_report

Request body

enable_last_dayboolean

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

limitinteger

The response resources limit. Defaults to 10.

offsetinteger

The response resources offset.

order_byCostReportOrderByChoices[]

List of sorting criteria in 'field.direction' format.

projectsinteger[] nullable

List of project IDs

regionsinteger[]

List of region IDs.

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

{
  "limit": 10,
  "order_by": [
    "project.asc",
    "region.desc"
  ],
  "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

OK

countinteger required

Total count of the resources

Example response

{
  "count": 1,
  "resources": [
    {
      "billing_metric_name": "bm3-ai-1xlarge-h100-80-8_min",
      "billing_value": 1000,
      "billing_value_unit": "minutes",
      "first_seen": "2024-07-01T00:00:30Z",
      "flavor": "bm3-ai-1xlarge-h100-80-8",
      "last_name": "ai_cluster_name",
      "last_seen": "2024-07-30T23:59:30Z",
      "project_id": 10,
      "region": 76,
      "region_id": 76,
      "tags": [
        {
          "os_distro": "ubuntu"
        },
        {
          "os_version": "22.04"
        }
      ]
    }
  ],
  "totals": [
    {
      "billing_metric_name": "bm3-ai-1xlarge-h100-80-8_min",
      "billing_value": 1000,
      "billing_value_unit": "minutes",
      "flavor": "bm3-ai-1xlarge-h100-80-8",
      "region": 76,
      "region_id": 76
    }
  ]
}