Skip to main content
GET
Showback by tag over time

Authorizations

Authorization
string
header
required

Enter "Bearer {token}"

Headers

X-CostGraph-Tenant-ID
string
required

Tenant ID

Query Parameters

tag_key
string
required

Tag or virtual-tag key to show back by

granularity
enum<string>

Length of each point; defaults to day

Available options:
day,
week,
month
layer
enum<string>

Cost layer; defaults to billed. allocation splits Kubernetes clusters into namespaces and workloads; database splits connected PostgreSQL instances into their databases and roles; layers are never mixed

Available options:
billed,
allocation,
database
period
enum<string>

Cost period; defaults to month_to_date

Available options:
month_to_date,
last_7d,
last_30d,
calendar_month,
custom
month
string

Closed calendar month in YYYY-MM format; required when period=calendar_month

start
string

Window start in RFC3339 format; required when period=custom

end
string

Window end in RFC3339 format; required when period=custom

reporting_currency
string

ISO 4217 code to express every amount in; defaults to the currency most of the period's spend was billed in

filter
string[]

Repeated key:value dimension filter, the same vocabulary as the cost query filter

Response

OK

message
string
required
Example:

"some message"

status
string
required
Example:

"success"

data
object