The 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 Anzeigen der Nutzung getakteter Produkte und Lizenzen.
Report types
There are three different types of reports.
- Metered usage page:
- Summarized metered usage reports: A summary of usage for all paid products for a maximum period of one year.
- Detailed metered usage reports: A detailed usage report for all paid products for a maximum period of 31 days.
- Premium request analytics page:
- Premium request analytics usage reports: A detailed, user-based report on usage of premium requests for the last 45 days.
Summarized metered usage reports
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 metered usage reports
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 request analytics usage reports
This report includes each recorded use of a premium request and includes the following fields: Timestamp,User,Model,Requests Used,Exceeds Monthly Quota, and Total Monthly Quota.
Metered usage report fields
The usage report contains 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. Only available in the detailed 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 report. |
cost_center_name | The cost center associated with the usage, if applicable. |
Metered usage report fields that are closing down
GitHub aims to minimize changes to the usage report structure, however at times the report structure or fields may change.
| Closing down | Replacement |
|---|---|
usage_at | Refer to date instead. |
workflow_name | Refer to workflow_path instead. |
Premium request analytics usage report fields
Hinweis
Premium request analytics data are available from August 1, 2025 onward.
The premium request analytics report contains the following fields.
| Field | Description |
|---|---|
| Timestamp | The full UTC date and time in ISO 18601 format. |
| User | The GitHub handle of the user associated with the usage. |
| Model | The model used. This might be an LLM like claude-sonnet-4, or a product-specific model like Code Review model. |
| Requests Used | The total number of requests used. |
| Exceeds Monthly Quota | This field indicates whether the premium request will be billed separately: - 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 |
| Total Monthly Quota | This field records the total number of requests included in the user's current plan. |
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.