Sign in
latestOpenAPI 3.0.42026-08-213579001013.0 KB

5f993bd211f5

Billing

Gets the overview for a billing period by its ID.

Set includeNonBillable to also report the period's non-billable cost. The existing totals stay billable-only; the non-billable amounts are reported in their own fields.

get/billing-period/{billingPeriodId}

Path parameters

billingPeriodIdstring required

The ID of the billing period to retrieve.

Query parameters

includeNonBillableboolean

Whether to also report non-billable cost.

Response

OK

idstring required

The billing period ID.

organizationIdstring required

The organization the billing period belongs to.

startDatestring date-time required

The start date of the billing period.

endDatestring date-time required

The end date of the billing period.

status'Open' | 'Invoiced' | 'Void' | 'Reconciling' | 'PendingReview' | 'Closed' required
totalGrossCostnumber double required

The total gross cost before discounts.

totalDiscountnumber double required

The total discount amount.

totalNetCostnumber double required

The total net cost after discounts.

totalResponseCountinteger required

The total number of billable responses.

totalNonBillableCostnumber double nullable

The gross cost of the period's non-billable activity, if it was requested.

totalNonBillableResponseCountinteger nullable

The total number of non-billable responses, if it was requested.

netInvoiceableAmountnumber double nullable

What an invoice for this period would charge, as of the last settlement: usage net of discounts plus charges, minus the voucher coverage already booked. Null until the period has been settled.

voucherCoveragenumber double nullable

How much of the period's billable usage vouchers absorbed at the last settlement.

settlementCurrencystring nullable

The currency the settlement amounts are denominated in.

settledAtstring date-time nullable

When the period was last settled.

settlementStaleboolean required

Whether a billing input changed after the settlement amounts were computed, so they are awaiting a recompute.

closedBystring nullable

The operator who closed the period without invoicing it. Null when the period closed on its own because nothing was left to invoice.

closeReasonstring nullable

Why the period was closed without being invoiced.

closedAtstring date-time nullable

When the period was closed without being invoiced.