Billing

Gets the overview for a billing period by its ID.

Changed on

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}

Request

  • Base URL
    https://api.rapidata.ai
  • URL
    https://api.rapidata.ai/billing-period/{billingPeriodId}
  • Auth
    OpenID Connect (https://auth.rapidata.ai/.well-known/openid-configuration, scopes: openid, profile, email, offline_access, api)

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.

Changes

  • 9da534659e5fRevision changes
    • info

      the security scope api was added to the endpoint's security scheme OpenIdConnect

  • 5f993bd211f5Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status