Get cost report resources sorted by cost (pay-as-you-go only)
curl --request POST \
--url https://api.gcore.com/cloud/v2/cost_report/resources \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"time_from": "2023-01-01T00:00:00Z",
"time_to": "2023-02-01T00:00:00Z",
"enable_last_day": false,
"limit": 10,
"offset": 0,
"order_by": [
"cost.desc"
],
"project_ids": [
16,
17,
18,
19,
20
],
"region_ids": [
0,
76
],
"response_format": "csv_records",
"search": "amsterdam",
"tags": {
"condition_type": "OR",
"conditions": [
{
"key": "os_version",
"strict": true,
"value": "22.04"
},
{
"key": "os_version",
"strict": true,
"value": "23.04"
}
]
},
"types": [
"egress_traffic",
"instance"
]
}
'import requests
url = "https://api.gcore.com/cloud/v2/cost_report/resources"
payload = {
"time_from": "2023-01-01T00:00:00Z",
"time_to": "2023-02-01T00:00:00Z",
"enable_last_day": False,
"limit": 10,
"offset": 0,
"order_by": ["cost.desc"],
"project_ids": [16, 17, 18, 19, 20],
"region_ids": [0, 76],
"response_format": "csv_records",
"search": "amsterdam",
"tags": {
"condition_type": "OR",
"conditions": [
{
"key": "os_version",
"strict": True,
"value": "22.04"
},
{
"key": "os_version",
"strict": True,
"value": "23.04"
}
]
},
"types": ["egress_traffic", "instance"]
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
time_from: '2023-01-01T00:00:00Z',
time_to: '2023-02-01T00:00:00Z',
enable_last_day: false,
limit: 10,
offset: 0,
order_by: ['cost.desc'],
project_ids: [16, 17, 18, 19, 20],
region_ids: [0, 76],
response_format: 'csv_records',
search: 'amsterdam',
tags: {
condition_type: 'OR',
conditions: [
{key: 'os_version', strict: true, value: '22.04'},
{key: 'os_version', strict: true, value: '23.04'}
]
},
types: ['egress_traffic', 'instance']
})
};
fetch('https://api.gcore.com/cloud/v2/cost_report/resources', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.gcore.com/cloud/v2/cost_report/resources",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'time_from' => '2023-01-01T00:00:00Z',
'time_to' => '2023-02-01T00:00:00Z',
'enable_last_day' => false,
'limit' => 10,
'offset' => 0,
'order_by' => [
'cost.desc'
],
'project_ids' => [
16,
17,
18,
19,
20
],
'region_ids' => [
0,
76
],
'response_format' => 'csv_records',
'search' => 'amsterdam',
'tags' => [
'condition_type' => 'OR',
'conditions' => [
[
'key' => 'os_version',
'strict' => true,
'value' => '22.04'
],
[
'key' => 'os_version',
'strict' => true,
'value' => '23.04'
]
]
],
'types' => [
'egress_traffic',
'instance'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.gcore.com/cloud/v2/cost_report/resources"
payload := strings.NewReader("{\n \"time_from\": \"2023-01-01T00:00:00Z\",\n \"time_to\": \"2023-02-01T00:00:00Z\",\n \"enable_last_day\": false,\n \"limit\": 10,\n \"offset\": 0,\n \"order_by\": [\n \"cost.desc\"\n ],\n \"project_ids\": [\n 16,\n 17,\n 18,\n 19,\n 20\n ],\n \"region_ids\": [\n 0,\n 76\n ],\n \"response_format\": \"csv_records\",\n \"search\": \"amsterdam\",\n \"tags\": {\n \"condition_type\": \"OR\",\n \"conditions\": [\n {\n \"key\": \"os_version\",\n \"strict\": true,\n \"value\": \"22.04\"\n },\n {\n \"key\": \"os_version\",\n \"strict\": true,\n \"value\": \"23.04\"\n }\n ]\n },\n \"types\": [\n \"egress_traffic\",\n \"instance\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.gcore.com/cloud/v2/cost_report/resources")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"time_from\": \"2023-01-01T00:00:00Z\",\n \"time_to\": \"2023-02-01T00:00:00Z\",\n \"enable_last_day\": false,\n \"limit\": 10,\n \"offset\": 0,\n \"order_by\": [\n \"cost.desc\"\n ],\n \"project_ids\": [\n 16,\n 17,\n 18,\n 19,\n 20\n ],\n \"region_ids\": [\n 0,\n 76\n ],\n \"response_format\": \"csv_records\",\n \"search\": \"amsterdam\",\n \"tags\": {\n \"condition_type\": \"OR\",\n \"conditions\": [\n {\n \"key\": \"os_version\",\n \"strict\": true,\n \"value\": \"22.04\"\n },\n {\n \"key\": \"os_version\",\n \"strict\": true,\n \"value\": \"23.04\"\n }\n ]\n },\n \"types\": [\n \"egress_traffic\",\n \"instance\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gcore.com/cloud/v2/cost_report/resources")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"time_from\": \"2023-01-01T00:00:00Z\",\n \"time_to\": \"2023-02-01T00:00:00Z\",\n \"enable_last_day\": false,\n \"limit\": 10,\n \"offset\": 0,\n \"order_by\": [\n \"cost.desc\"\n ],\n \"project_ids\": [\n 16,\n 17,\n 18,\n 19,\n 20\n ],\n \"region_ids\": [\n 0,\n 76\n ],\n \"response_format\": \"csv_records\",\n \"search\": \"amsterdam\",\n \"tags\": {\n \"condition_type\": \"OR\",\n \"conditions\": [\n {\n \"key\": \"os_version\",\n \"strict\": true,\n \"value\": \"22.04\"\n },\n {\n \"key\": \"os_version\",\n \"strict\": true,\n \"value\": \"23.04\"\n }\n ]\n },\n \"types\": [\n \"egress_traffic\",\n \"instance\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"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
}
}
]
}Cost Reports
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
Get cost report resources sorted by cost (pay-as-you-go only)
curl --request POST \
--url https://api.gcore.com/cloud/v2/cost_report/resources \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"time_from": "2023-01-01T00:00:00Z",
"time_to": "2023-02-01T00:00:00Z",
"enable_last_day": false,
"limit": 10,
"offset": 0,
"order_by": [
"cost.desc"
],
"project_ids": [
16,
17,
18,
19,
20
],
"region_ids": [
0,
76
],
"response_format": "csv_records",
"search": "amsterdam",
"tags": {
"condition_type": "OR",
"conditions": [
{
"key": "os_version",
"strict": true,
"value": "22.04"
},
{
"key": "os_version",
"strict": true,
"value": "23.04"
}
]
},
"types": [
"egress_traffic",
"instance"
]
}
'import requests
url = "https://api.gcore.com/cloud/v2/cost_report/resources"
payload = {
"time_from": "2023-01-01T00:00:00Z",
"time_to": "2023-02-01T00:00:00Z",
"enable_last_day": False,
"limit": 10,
"offset": 0,
"order_by": ["cost.desc"],
"project_ids": [16, 17, 18, 19, 20],
"region_ids": [0, 76],
"response_format": "csv_records",
"search": "amsterdam",
"tags": {
"condition_type": "OR",
"conditions": [
{
"key": "os_version",
"strict": True,
"value": "22.04"
},
{
"key": "os_version",
"strict": True,
"value": "23.04"
}
]
},
"types": ["egress_traffic", "instance"]
}
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
time_from: '2023-01-01T00:00:00Z',
time_to: '2023-02-01T00:00:00Z',
enable_last_day: false,
limit: 10,
offset: 0,
order_by: ['cost.desc'],
project_ids: [16, 17, 18, 19, 20],
region_ids: [0, 76],
response_format: 'csv_records',
search: 'amsterdam',
tags: {
condition_type: 'OR',
conditions: [
{key: 'os_version', strict: true, value: '22.04'},
{key: 'os_version', strict: true, value: '23.04'}
]
},
types: ['egress_traffic', 'instance']
})
};
fetch('https://api.gcore.com/cloud/v2/cost_report/resources', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.gcore.com/cloud/v2/cost_report/resources",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'time_from' => '2023-01-01T00:00:00Z',
'time_to' => '2023-02-01T00:00:00Z',
'enable_last_day' => false,
'limit' => 10,
'offset' => 0,
'order_by' => [
'cost.desc'
],
'project_ids' => [
16,
17,
18,
19,
20
],
'region_ids' => [
0,
76
],
'response_format' => 'csv_records',
'search' => 'amsterdam',
'tags' => [
'condition_type' => 'OR',
'conditions' => [
[
'key' => 'os_version',
'strict' => true,
'value' => '22.04'
],
[
'key' => 'os_version',
'strict' => true,
'value' => '23.04'
]
]
],
'types' => [
'egress_traffic',
'instance'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.gcore.com/cloud/v2/cost_report/resources"
payload := strings.NewReader("{\n \"time_from\": \"2023-01-01T00:00:00Z\",\n \"time_to\": \"2023-02-01T00:00:00Z\",\n \"enable_last_day\": false,\n \"limit\": 10,\n \"offset\": 0,\n \"order_by\": [\n \"cost.desc\"\n ],\n \"project_ids\": [\n 16,\n 17,\n 18,\n 19,\n 20\n ],\n \"region_ids\": [\n 0,\n 76\n ],\n \"response_format\": \"csv_records\",\n \"search\": \"amsterdam\",\n \"tags\": {\n \"condition_type\": \"OR\",\n \"conditions\": [\n {\n \"key\": \"os_version\",\n \"strict\": true,\n \"value\": \"22.04\"\n },\n {\n \"key\": \"os_version\",\n \"strict\": true,\n \"value\": \"23.04\"\n }\n ]\n },\n \"types\": [\n \"egress_traffic\",\n \"instance\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.gcore.com/cloud/v2/cost_report/resources")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"time_from\": \"2023-01-01T00:00:00Z\",\n \"time_to\": \"2023-02-01T00:00:00Z\",\n \"enable_last_day\": false,\n \"limit\": 10,\n \"offset\": 0,\n \"order_by\": [\n \"cost.desc\"\n ],\n \"project_ids\": [\n 16,\n 17,\n 18,\n 19,\n 20\n ],\n \"region_ids\": [\n 0,\n 76\n ],\n \"response_format\": \"csv_records\",\n \"search\": \"amsterdam\",\n \"tags\": {\n \"condition_type\": \"OR\",\n \"conditions\": [\n {\n \"key\": \"os_version\",\n \"strict\": true,\n \"value\": \"22.04\"\n },\n {\n \"key\": \"os_version\",\n \"strict\": true,\n \"value\": \"23.04\"\n }\n ]\n },\n \"types\": [\n \"egress_traffic\",\n \"instance\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gcore.com/cloud/v2/cost_report/resources")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"time_from\": \"2023-01-01T00:00:00Z\",\n \"time_to\": \"2023-02-01T00:00:00Z\",\n \"enable_last_day\": false,\n \"limit\": 10,\n \"offset\": 0,\n \"order_by\": [\n \"cost.desc\"\n ],\n \"project_ids\": [\n 16,\n 17,\n 18,\n 19,\n 20\n ],\n \"region_ids\": [\n 0,\n 76\n ],\n \"response_format\": \"csv_records\",\n \"search\": \"amsterdam\",\n \"tags\": {\n \"condition_type\": \"OR\",\n \"conditions\": [\n {\n \"key\": \"os_version\",\n \"strict\": true,\n \"value\": \"22.04\"\n },\n {\n \"key\": \"os_version\",\n \"strict\": true,\n \"value\": \"23.04\"\n }\n ]\n },\n \"types\": [\n \"egress_traffic\",\n \"instance\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"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
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
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"
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"
Expenses for the last specified day are taken into account. As the default, False.
Example:
false
The response resources limit. Defaults to 10. Maximum 1000 for the json format, 10000 for the csv_records format.
Required range:
x <= 1000Example:
10
The response resources offset.
Required range:
x >= 0Example:
0
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"]
List of project IDs. Omit for all accessible projects; an empty list is rejected.
Minimum array length:
1Example:
[16, 17, 18, 19, 20]
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:
1Example:
[0, 76]
Format of the response: json (default) or csv_records.
Available options:
csv_records, json Examples:
"csv_records"
"json"
Partial, case-insensitive search over region names, project names, resource names, flavors and tags.
Required string length:
2 - 256Examples:
"amsterdam"
"web-01"
Filter by tags
Show child attributes
Show child attributes
Example:
{
"condition_type": "OR",
"conditions": [
{
"key": "os_version",
"strict": true,
"value": "22.04"
},
{
"key": "os_version",
"strict": true,
"value": "23.04"
}
]
}
List of resource types. Omit for all types; an empty list is rejected.
Minimum array length:
1Resource 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 of all the resources
Required range:
x >= 0Example:
45
'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 Show child attributes
Show child attributes
Was this page helpful?