---
title: Billing reports reference
shortTitle: Billing reports
intro: 'Billing reports show detailed {% data variables.product.github %} usage, {% data variables.product.prodname_ai_credits_short %} consumption, and billing information for your account.'
versions:
  fpt: '*'
  ghec: '*'
  ghes: '*'
permissions: '{% data reusables.permissions.enhanced-billing-enterprise %}'
redirect_from:
  - /billing/managing-your-billing/about-usage-reports
  - /billing/reference/usage-reports
contentType: reference
category:
  - Track spending and control costs
---

Usage reports show detailed information about your account’s {% data variables.product.github %} usage, including how much of each SKU was used and the resulting billable amount.

To generate a usage report, see [AUTOTITLE](/billing/how-tos/products/view-productlicense-use#downloading-usage-reports).

## 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.
* AI usage page:
   * **AI usage report**: A detailed per-user breakdown of {% data variables.product.prodname_ai_credits_short %} 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`.

{% data reusables.billing.usage-reports-api-limitation %}

### AI usage report

This report includes additional detail about {% data variables.product.prodname_ai_credits_short %} consumption. The report sums the `quantity`, `gross_amount`, `discount_amount`, and `net_amount` fields based on the combination of the following values: `date`, `model`, `username`.

## 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 {% data variables.product.github %} product that was used. |
| `sku`                    | The specific {% data variables.product.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 {% data variables.product.prodname_actions %} usage for standard {% data variables.product.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. <br><br> 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 {% data variables.product.prodname_actions %} workflow that generated the usage, if applicable. <br><br>Only available in the `Detailed usage report` |
| `cost_center_name`       | The cost center associated with the usage, if applicable. |
| `model` | The model used, for example `claude-sonnet-4`. <br><br>Only available in the `AI usage report` |

## Receiving the report

Usage reports are sent via email to the default email address associated with your {% data variables.product.github %} account. You can only request one usage report per account at a time.

## Metered usage report fields that have closed down

{% data variables.product.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. |