BillingImport
The state of the imports of a billing source.
object
A source of the billing imports (billing_sources): a cloud provider, or plugin, the
operator’s plugin that aggregates any other providers.
The provider’s name, as the breakdown of the totals shows it.
How the source reads the provider’s data: cost_explorer (AWS Cost
Explorer) and bigquery (the Cloud Billing export to BigQuery, billing_gcp_method = bigquery) by service and charge type; budget (the notifications of a Cloud Billing budget,
billing_gcp_method = budget) an approximation, one estimated total per budget and month
without a breakdown by service; billable_usage (Cloudflare’s billable usage) the usage
charges of a pay-as-you-go account by product, without fixed fees, taxes, or credits;
plugin (the operator’s plugin) what the plugin reports.
The IANA time zone of the provider’s billing months (UTC, America/Los_Angeles, or
the operator’s choice for a plugin), kept as the provider reports them.
Schema: BillingImportRun
object
When the last successful import ran; omitted before the first.
The billed requests of the imports this UTC day.
The billed requests of the imports this UTC month.
The cap of the billed requests per UTC day (billing_aws_max_requests_per_day);
omitted for a source without caps.
The cap of the billed requests per UTC month (billing_aws_max_requests_per_month);
omitted for a source without caps.
The bytes billed this UTC month, of BigQuery or as a plugin reports them; 0 for the other sources.
The billing months of the last year with imported costs, newest first.
A billing month of a source: an estimate while the provider has not closed it, final
once it has, correction once a value changed after that; with its totals by currency.
object
The billing month, YYYY-MM in the source’s time zone.
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
Example generated
{ "source": "aws", "provider": "example", "method": "cost_explorer", "time_zone": "example", "last_run": {}, "last_success_at": "2026-04-15T12:00:00Z", "requests_today": 1, "requests_this_month": 1, "max_requests_per_day": 1, "max_requests_per_month": 1, "bytes_billed_this_month": 1, "months": [ { "month": "example", "kind": "estimate", "totals": [ { "amount": "example", "currency": "example" } ] } ]}For LLMs and coding agents:llms.txt,llms-full.txt, llms-small.txt