Usage reports show 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 Viewing your usage of metered products and licenses.

Report types

The following report types are available.

• Metered usage page:
  • Summarized usage report: A summary of usage for all paid products for a maximum period of one year.
  • Detailed usage report: A detailed usage report for all paid products for a maximum period of 31 days.
• Premium request analytics page:
  • Premium requests usage report: A detailed per-user breakdown of premium requests consumed for a maximum period of 31 days.

Summarized usage report

This 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.

Detailed usage report

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

This 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.

Premium requests usage report

This report includes additional detail about premium request usage. The report sums the quantity, gross_amount, discount_amount, and net_amount fields based on the combination of the following values: date, model, username.

This report contains usage beginning October 01, 2025 00:00 UTC.

Usage report fields

The usage reports contain the following fields.

Field	Description
date	The day that the usage occurred. All usage is logged in UTC.
product	The GitHub product that was used.
sku	The specific GitHub product SKU that was used.
quantity	The amount of the SKU that was used.
unit_type	The unit of measurement for the product SKU.
applied_cost_per_quantity	The unit cost of the product SKU.
gross_amount	The amount of the product SKU that was used.
discount_amount	The 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_amount	The 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
username	The user associated with the usage, if applicable. Not included in the Summarized usage report.
organization	The organization associated with the usage, if applicable.
repository	The repository associated with the usage, if applicable.
workflow_path	The path of the GitHub Actions workflow that generated the usage, if applicable. Only available in the Detailed usage report
cost_center_name	The cost center associated with the usage, if applicable.
model	The model used. This might be an LLM like claude-sonnet-4, or a product-specific model like Code Review model. Only available in the Premium request usage report
exceeds_quota	Indicates whether the premium request exceeds the user's monthly quota: - FALSE: The request is covered by the monthly quota included in the user's plan. - TRUE: The request exceeds the monthly quota and will be billed Only available in the Premium request usage report
total_monthly_quota	The number of requests included in the user's current plan. See About individual GitHub Copilot plans and benefits and About billing for GitHub Copilot in organizations and enterprises. Only available in the Premium request usage report

Receiving the report

Usage reports are sent via email to the default email address associated with your GitHub account. You can only request one usage report per account at a time.

Metered usage report fields that have closed down

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

The following fields have been removed from the usage reports.

Field	Replacement
usage_at	Refer to date instead.
workflow_name	Refer to workflow_path instead.