CostTotals
The totals of the instance’s costs over the periods from the one that holds from to the
one that holds to, oldest first.
object
The periods of the totals: ISO 8601 weeks (Monday to Sunday), calendar months, or calendar years, cut by date.
How the totals place a payment. amortized (the default) spreads each
payment of a schedule longer than a month (every 2 or more months, every year, every 5 or
more weeks) by day over the days up to the next payment, with the cumulative rounding;
the other payments stay on their dates. cash places every payment on its date. Imported
usage charges spread by day over their billing period under both.
A week, month, or year of the totals (label: 2026-W17, 2026-04, or 2026): the total
of each currency, never converted, sorted by currency code, and the breakdown
by provider, category, and currency. A currency appears when a cost meets the period, even
with a zero amount. estimated reports that an imported usage charge of a billing month
that its provider has not closed meets the period: its amount may still
change.
object
A calendar date YYYY-MM-DD without a time or a time zone, such as the day
of a payment on a card statement or an invoice.
A calendar date YYYY-MM-DD without a time or a time zone, such as the day
of a payment on a card statement or an invoice.
An amount of money: a decimal string in the major unit with the digits of
its currency (12.34 USD, 1650 JPY), never a JSON number, and its ISO 4217 code.
object
The amount of a provider, category, and currency in a period. The costs group by the provider
in NFKC and lower case, so ConoHa, conoha, and ConoHa share a line.
object
The provider as entered, one spelling for every line of the same grouped provider
in the period: the provider of the cost item whose current label was revised last among the
items with payments in the period (the larger revision ID on a tie), or, for a provider of
imported costs only, the import’s provider name (AWS, Google Cloud).
The fixed category of a cost; clients translate its name.
Schema: Money
object
Schema: CostTotalsRules
object
Example generated
{ "granularity": "week", "basis": "amortized", "periods": [ { "label": "example", "starts_on": "example", "ends_on": "example", "totals": [ { "amount": "example", "currency": "example" } ], "breakdown": [ { "provider": "example", "category": "compute", "amount": {} } ], "estimated": true } ], "rules": {}}For LLMs and coding agents:llms.txt,llms-full.txt, llms-small.txt