Skip to content

BillingImport

The state of the imports of a billing source.

object
source
required

A source of the billing imports (billing_sources): a cloud provider, or plugin, the operator’s plugin that aggregates any other providers.

string
Allowed values: aws gcp cloudflare plugin
provider
required

The provider’s name, as the breakdown of the totals shows it.

string
method
required

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.

string
Allowed values: cost_explorer bigquery budget billable_usage plugin
time_zone
required

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.

string
last_run
object
last_success_at

When the last successful import ran; omitted before the first.

string format: date-time
requests_today
required

The billed requests of the imports this UTC day.

integer
requests_this_month
required

The billed requests of the imports this UTC month.

integer
max_requests_per_day

The cap of the billed requests per UTC day (billing_aws_max_requests_per_day); omitted for a source without caps.

integer
>= 1
max_requests_per_month

The cap of the billed requests per UTC month (billing_aws_max_requests_per_month); omitted for a source without caps.

integer
>= 1
bytes_billed_this_month
required

The bytes billed this UTC month, of BigQuery or as a plugin reports them; 0 for the other sources.

integer format: int64
months
required

The billing months of the last year with imported costs, newest first.

Array<object>

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
month
required

The billing month, YYYY-MM in the source’s time zone.

string
/^[0-9]{4}-[0-9]{2}$/
kind
required
string
Allowed values: estimate final correction
totals
required
Array<object>

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
amount
required
string
/^-?[0-9]+(\.[0-9]+)?$/
currency
required
string
/^[A-Z]{3}$/

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

Analytics on this site