Skip to main content
POST
/
cloud
/
v1
/
cost_report
/
resources
Python
from datetime import datetime
from gcore import Gcore

client = Gcore(
    api_key="My API Key",
)
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)
{
  "count": 1,
  "price_status": "error",
  "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",
      "err": null,
      "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"
        }
      ],
      "type": "<string>",
      "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ]
}

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.

Examples:

"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.

Examples:

"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.

Examples:

false

​
limit
integer
default:10

The response resources limit. Defaults to 10.

Required range: x > 0
Examples:

10

​
offset
integer
default:0

The response resources offset.

Required range: x >= 0
Examples:

0

​
projects
integer[]

List of project IDs

Examples:
[16, 17, 18, 19, 20]
​
regions
integer[]

List of region IDs.

Examples:
[1, 2, 3]
​
response_format
enum<string>

Format of the response (csv or json).

Available options:
csv_records,
json
​
rounding
boolean
default:true

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

​
schema_filter
object

Extended filter for field filtering.

  • SchemaFilterSnapshotSerializer
  • SchemaFilterInstanceSerializer
  • SchemaFilterAiClusterSerializer
  • SchemaFilterAiVirtualClusterSerializer
  • SchemaFilterBasicVmSerializer
  • SchemaFilterBaremetalSerializer
  • SchemaFilterVolumeSerializer
  • SchemaFilterFileShareSerializer
  • SchemaFilterImageSerializer
  • SchemaFilterFloatingIpSerializer
  • SchemaFilterEgressTrafficSerializer
  • SchemaFilterLoadBalancerSerializer
  • SchemaFilterExternalIpSerializer
  • SchemaFilterBackupSerializer
  • SchemaFilterLogIndexSerializer
  • SchemaFilterFunctionsSerializer
  • SchemaFilterFunctionsCallsSerializer
  • SchemaFilterFunctionsTrafficSerializer
  • SchemaFilterContainersSerializer
  • SchemaFilterInferenceSerializer
  • SchemaFilterDBAASPostgreSQLVolumeSerializer
  • SchemaFilterDBAASPostgreSQLPublicNetworkSerializer
  • SchemaFilterDBAASPostgreSQLCPUSerializer
  • SchemaFilterDBAASPostgreSQLMemorySerializer
  • SchemaFilterDBAASPostgreSQLPoolerSerializer
Examples:
{
  "field": "flavor",
  "type": "instance",
  "values": ["g1-standard-1-2"]
}
​
sorting
CostReportResourcesSortingRequestSerializer · object[]

List of sorting filters (JSON objects) fields: project. directions: asc, desc.

​
tags
object

Filter by tags

​
types
enum<string>[]

List of resource types to be filtered in the report.

Examples:
["egress_traffic", "instance"]

Response

200 - application/json

OK

​
count
integer
required

Count of all the resources

Required range: x >= 0
Examples:

1

​
price_status
enum<string>
required

Price status for the UI, type: string

Available options:
error,
hide,
show
​
results
Results · array
required
  • ResourceAiClusterWithCostSerializer
  • ResourceAiVirtualClusterWithCostSerializer
  • ResourceBaremetalWithCostSerializer
  • ResourceBasicVmWithCostSerializer
  • ResourceBackupWithCostSerializer
  • ResourceContainerWithCostSerializer
  • ResourceEgressTrafficWithCostSerializer
  • ResourceExternalIpWithCostSerializer
  • ResourceFileShareWithCostSerializer
  • ResourceFloatingIpWithCostSerializer
  • ResourceFunctionsWithCostSerializer
  • ResourceFunctionCallsWithCostSerializer
  • ResourceFunctionEgressTrafficWithCostSerializer
  • ResourceImagesWithCostSerializer
  • ResourceInferenceWithCostSerializer
  • ResourceInstanceWithCostSerializer
  • ResourceLoadBalancerWithCostSerializer
  • ResourceLogIndexWithCostSerializer
  • ResourceSnapshotWithCostSerializer
  • ResourceVolumeWithCostSerializer
  • ResourceDBAASPostgreSQLPoolerWithCostSerializer
  • ResourceDBAASPostgreSQLMemoryWithCostSerializer
  • ResourceDBAASPostgreSQLPublicNetworkWithCostSerializer
  • ResourceDBAASPostgreSQLCPUWithCostSerializer
  • ResourceDBAASPostgreSQLVolumeWithCostSerializer