Get a company's spend for the open billing period
Instance-admin view of GET /api/v3/usage/current-period for a specific company: total_cost for the billing period now open plus a per-feature breakdown, highest cost first.
Identical payload and identical derivation to the company-facing endpoint — the back-office and the customer’s own usage page must never quote different figures.
Authorization: the authenticated user must have instance-level company-view permission (SysAdmin, Account Manager, or DPO Admin).
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Response
ISO 4217 code applied to every cost in the response
First day of the billing period now open (UTC)
First day of the next billing period — when this period's invoice is issued
Sum of by_feature, in currency
Per-feature breakdown, highest cost first. Features with no usage are omitted, so an unused period returns an empty list and a total_cost of 0