v56

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-011,4581,08113.3 MB
billing

Get billing usage report for an enterprise

Gets a report of usage by cost center for an enterprise. To use this endpoint, you must be an administrator or billing manager of the enterprise. By default this endpoint will return usage that does not have a cost center.

Note: This endpoint is only available to enterprises with access to the enhanced billing platform. For more information, see "About the enhanced billing platform for enterprises."

get/enterprises/{enterprise}/settings/billing/usage

Path parameters

enterprisestring required

The slug version of the enterprise name.

Query parameters

yearinteger

If specified, only return results for a single year. The value of year is an integer with four digits representing a year. For example, 2025. Default value is the current year.

monthinteger

If specified, only return results for a single month. The value of month is an integer between 1 and 12. If no year is specified the default year is used.

dayinteger

If specified, only return results for a single day. The value of day is an integer between 1 and 31. If no year or month is specified, the default year and month are used.

cost_center_idstring

The ID corresponding to a cost center. The default value is no cost center.

Response

Response when getting a billing usage report