Get cost report resources sorted by cost (pay-as-you-go only)

Get a detailed cost report for a given period and specific resources, sorted by cost by default. Requested period should not exceed 31 days. Costs and usages are always returned at full precision.

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/v2/cost_report/resources

Python

Python

import os
from datetime import datetime
from gcore import Gcore

client = Gcore(
    api_key=os.environ.get("GCORE_API_KEY"),  # This is the default and can be omitted
)
cost_report_detailed = client.cloud.cost_reports.get_detailed(
    time_from=datetime.fromisoformat("2023-01-01T00:00:00"),
    time_to=datetime.fromisoformat("2023-02-01T00:00:00"),
)
print(cost_report_detailed.count)

200

{
  "count": 45,
  "price_status": "error",
  "results": [
    {
      "error": null,
      "project_id": 101,
      "region_id": 76,
      "resource": {
        "flavor": "bm2-infrastructure-medium",
        "name": "bm-amsterdam-1fe6",
        "tags": [
          {
            "os_distro": "ubuntu"
          },
          {
            "os_version": "22.04"
          }
        ],
        "type": "baremetal",
        "uuid": "066e202a-fc9a-43f2-a74d-be34afbee5c9"
      },
      "usage": {
        "cost": 163.190753,
        "currency": "EUR",
        "first_seen": "2026-07-17T00:00:30Z",
        "last_seen": "2026-07-23T23:59:30Z",
        "unit": "gb_hours",
        "value": 6688
      }
    }
  ]
}

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

Body

application/json

time_from · string<date-time> · required

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

Example:

"2023-01-01T00:00:00Z"

time_to · string<date-time> · required

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

Example:

"2023-02-01T00:00:00Z"

enable_last_day · boolean · default: false

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

Example:

false

limit · integer · default: 10

The response resources limit. Defaults to 10. Maximum 1000 for the json format, 10000 for the csv_records format.

Required range: x <= 1000

Example:

10

offset · integer · default: 0

The response resources offset.

Required range: x >= 0

Example:

0

order_by · enum<string>[]

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

v1's sort fields plus cost, renamed to say which field is actually sorted on.

There is no region sort: prebilling can only order by region name, and the response exposes region_id, so no token here could honestly describe it.

Tokens are flat, not response paths: flavor -> resource.flavor, resource_name -> resource.name, usage -> usage.value, cost -> usage.cost, first_seen/last_seen -> usage.first_seen/usage.last_seen.

Available options: cost.asc, cost.desc, first_seen.asc, first_seen.desc, flavor.asc, flavor.desc, last_seen.asc, last_seen.desc, project_id.asc, project_id.desc, resource_name.asc, resource_name.desc, usage.asc, usage.desc

Example:

["cost.desc"]

project_ids · integer[]

List of project IDs. Omit for all accessible projects; an empty list is rejected.

Minimum array length: 1

Example:

[16, 17, 18, 19, 20]

region_ids · integer[]

List of region IDs. Omit for all regions and global usage; an empty list is rejected. Use 0 for global usage that has no region.

Minimum array length: 1

Example:

[0, 76]

response_format · enum<string> · default: json

Format of the response: json (default) or csv_records.

Available options: csv_records, json

Examples:

"csv_records"

"json"

search · string

Partial, case-insensitive search over region names, project names, resource names, flavors and tags.

Required string length: 2 - 256

Examples:

"amsterdam"

"web-01"

tags · TagsFilterSerializer · object

Filter by tags

Show child attributes

Example:

{
  "condition_type": "OR",
  "conditions": [
    {
      "key": "os_version",
      "strict": true,
      "value": "22.04"
    },
    {
      "key": "os_version",
      "strict": true,
      "value": "23.04"
    }
  ]
}

types · enum<string>[]

List of resource types. Omit for all types; an empty list is rejected.

Minimum array length: 1

Resource types for prebilling report

Available options: ai_cluster, ai_virtual_cluster, backup, baremetal, basic_vm, containers, dbaas_postgresql_connection_pooler, dbaas_postgresql_cpu, dbaas_postgresql_memory, dbaas_postgresql_public_network, dbaas_postgresql_volume, egress_traffic, external_ip, file_share, floatingip, functions, functions_calls, functions_traffic, image, inference, inference_public_models, instance, load_balancer, log_index, snapshot, volume

Example:

["egress_traffic", "instance"]

Response

200

application/json

Cost report resources

count · integer · required

Count of all the resources

Required range: x >= 0

Example:

45

price_status · enum<string> · required

'show' when the client may see prices, 'hide' for trial clients, clients with no product status, and clients of a reseller that does not expose prices.

Available options: error, hide, show

results · CostReportResourcesV2ResultSerializer · object[] · required

Show child attributes