Downloading license use for your enterprise or organization

Get data on consumption of GitHub, Copilot, and Advanced Security licenses.

Who can use this feature?

Enterprise owners, organization owners, and billing managers (cloud)
Enterprise owners (server)

In this article

You can download CSV files with details of paid license use through the GitHub user interface or the REST API.

For more detailed reports on usage of all paid products, see Viewing your usage of metered products and licenses.

On GitHub Enterprise Cloud

  1. In the upper-right corner of any page on GitHub, click your profile picture.

  2. Select the account you want to view and then access the "Billing & Licensing" pages:

    • Organizations: Click Your organizations, then next to the organization, click Settings. In the organization sidebar, click Billing & Licensing.

    • Enterprises: Click Your enterprises, then click the enterprise name. Click the Billing & Licensing tab at the top of the page.

  3. From the list of "Billing & licensing" pages, click Licensing to display the licensing page.

  4. In the license area of interest, click Download CSV report. If offered a choice, choose your preferred report.

The report will be emailed to the default email address associated with your GitHub account. For information about the fields, see License reports reference.

On GitHub Enterprise Server

  1. In the top-right corner of GitHub, click your profile picture.
  2. Depending on your environment, click Your enterprise, or click Your enterprises then click the enterprise you want to view.
  3. Under Settings, click Licensing.

The page shows a summary of the licenses your enterprise is using for GitHub Enterprise and GitHub Advanced Security. Use links on the page to view more detailed information.

To download a license usage report for GitHub Advanced Security:

  • Enterprise: In "GitHub Advanced Security", click CSV report.
  • Organization: In the "ORGANIZATION" table, click associated with the organization that you want to download a CSV report for.
  • User namespace: In the "USER NAMESPACED" table, click associated with the user that you want to download a CSV report for.
  • Repository: In the "ORGANIZATION" table, click the name of an organization to show a settings page for the organization. In the GitHub Advanced Security repositories table, click and select Download CSV report.

For details of the fields included in the report, see License reports reference.

Using the REST API

You can retrieve information on paid use of Advanced Security with the billing API.

  • Organization-level data (cloud only), use the /organizations/{org}/settings/billing/usage endpoint. For more information, see Enhanced billing platform.

  • Enterprise-level data, use the /enterprises/{enterprise}/settings/billing/usage endpoint. For more information, see REST API endpoints for enterprise billing in the GitHub Enterprise Cloud documentation.