Skip to main content
GET
List Billing Costs

Authorizations

Authorization
string
header
required

Bearer scheme name used by typed customer admin operations.

Query Parameters

period
string
required

current or a closed calendar month YYYY-MM.

Response

Customer-aggregated itemized billing costs

Customer-level itemized cost response.

currency
string
required

ISO 4217 currency code; today always USD per umbrella scoping decision.

Example:

"USD"

customer_id
string
required

Stable UUID for the customer account.

line_items
object[]
required

Itemized line items, ordered by (tenant_slug, resource_kind, resource_class, usage_model) for stable client rendering.

period
object
required

Window covered by the response.

total_cents
integer<int64>
required

Customer total = sum of amount_cents across all line items.