Skip to main content

About usage reports

Learn how to request and understand a report that shows detailed GitHub usage and billing information for your account.

Who can use this feature?

Organization owners, billing managers, and personal account users

Outside of GitHub Enterprise Cloud, the new billing platform is available to:

  • Organization accounts on a GitHub Free plan created after February 4, 2025.
  • Personal accounts (either on GitHub Free or GitHub Pro) created after February 13, 2025.

For existing personal accounts created before February 13, 2025, GitHub will migrate personal accounts to the new billing platform by June 30, 2025.

The usage report shows detailed information about your account’s GitHub usage, including how much of each SKU was used and the resulting billable amount.

To generate a usage report, see Gathering insights on your spending.

Usage report types

Summarized report

The summarized usage report sums the quantity, gross_amount, discount_amount, and net_amount fields based on the combination of the following values: date, sku, repository, cost_center_name. If the usage report is for an enterprise with organizations, the amounts will be summarized by the organization value as well.

Summarized reports can be requested for a maximum time frame of one year.

Detailed report

The detailed usage report includes the same fields as the summarized report and adds username and workflow_path.

The detailed usage report sums the quantity, gross_amount, discount_amount, and net_amount fields based on the combination of the following values: date, sku, organization, repository, cost_center_name, username, workflow_path.

Detailed reports can be requested for a maximum time frame of 31 days.

Usage report fields

The usage report contains the following fields.

FieldDescription
dateThe day that the usage occurred. All usage is logged in UTC.
productThe GitHub product that was used.
skuThe specific GitHub product SKU that was used.
quantityThe amount of the SKU that was used.
unit_typeThe unit of measurement for the product SKU.
applied_cost_per_quantityThe unit cost of the product SKU.
gross_amountThe amount of the product SKU that was used.
discount_amountThe amount of usage that was discounted. Usage that is discounted as part of your account’s included usage is reflected in this field. Also includes discounts for GitHub Actions usage for standard GitHub-hosted runners in public repositories and for self-hosted runners.
net_amountThe billable amount of usage after applying the discount_amount. This is the amount that your account will be billed. gross_amount - discount_amount = net_amount.
usernameThe user associated with the usage, if applicable. Only available in the detailed report.
organizationThe organization associated with the usage, if applicable.
repositoryThe repository associated with the usage, if applicable.
workflow_pathThe path of the GitHub Actions workflow that generated the usage, if applicable. Only available in the detailed report.
cost_center_nameThe cost center associated with the usage, if applicable.

Deprecated report fields

GitHub aims to minimize changes to the usage report structure, however at times the report structure or fields may change.

Deprecated fieldReplacement
usage_atRefer to date instead.
workflow_nameRefer to workflow_path instead.

Receiving the report

Usage reports are sent via email to the default email address associated with your GitHub account.