v1

latestOpenAPI 3.0.0CoreStack Inc License2026-07-248001,5071.7 MB

Billing

Aggregate costs based on input criteria

Generate cost aggregation.

post/v2/billing/aggregation

Request body

service_account_idsstring[]

Service Account IDs

start_datestring date-time required

start of the spend period

end_datestring date-time required

end of the spend period

time_zonestring

Optional timezone of the caller

platform'kubernetes'

Platforms

skip_service_account_groupingboolean

If set, do not group by service account

billing_sourcestring required

Billing plan to select data from

limitinteger

If set, limits the results to given number.

billing_modeboolean

If set, results for cost data gets computed based on billing period start dates that falls in the range of the start date and end date.

include_resource_childrenboolean

If set, intercept the query operators to manipulate platform specific accounts. This is only applicable for ServiceAccountQueryOperator manipulation when the visitor is platform and call made through billing plans.

Example request

{
  "platform": "kubernetes",
  "group_by": [
    {
      "selector": "service_account_tags"
    }
  ]
}

Response

Success

valuenumber

Result of aggregation

Example response

[
  {
    "identity": {
      "currency": "AED"
    }
  }
]