v56

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

Get billing usage summary for an enterprise

Gets a summary report of usage 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 across all cost centers in the enterprise.

Note: Only data from the past 24 months is accessible via this endpoint.

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

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. Default value is the current month. 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.

organizationstring

The organization name to query usage for. The name is not case sensitive.

repositorystring

The repository name to query for usage in the format owner/repository.

productstring

The product name to query usage for. The name is not case sensitive.

skustring

The SKU to query for usage.

cost_center_idstring

The ID corresponding to a cost center. An ID of 'none' will target usage not associated to any cost center.

Response

Response when getting a billing usage summary

enterprisestring required

The name of the enterprise for the usage report.

organizationstring

The name of the organization for the usage report.

repositorystring

The name of the repository for the usage report.

productstring

The product for the usage report.

skustring

The SKU for the usage report.