billing

Get billing usage report for an organization

Gets a report of the total usage for an organization. To use this endpoint, you must be an administrator of an organization within an enterprise or an organization account.

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

get/organizations/{org}/settings/billing/usage

Request

  • Base URL: https://api.github.com
  • URL: https://api.github.com/organizations/{org}/settings/billing/usage
  • Auth: none declared

Path parameters

orgstring required

The organization name. The name is not case sensitive.

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.

Response

Billing usage report response for an organization

Changes

No recorded changes to this operation across all 23 revisions of this API.