Viewing and downloading licensed use of Advanced Security

You can view and download consumption of GitHub Advanced Security licenses by your enterprise: volume/subscription licenses or metered usage.

Who can use this feature?

Enterprise owners with Advanced Security

In this article

Viewing Advanced Security usage for your enterprise

You can view the current license limits and usage for your enterprise.

  1. In the top-right corner of GitHub Enterprise Server, click your profile photo, then click Enterprise settings.

    Screenshot of the dropdown menu shown when you click the profile photo on GitHub Enterprise Server. The "Enterprise settings" option is outlined.

  2. Under Settings, click License.

    The "GitHub Advanced Security" section shows details of the current usage. You can see the total number of licenses used, as well as a table with the number of committers and unique committers for each organization.

  3. Optionally, to see a detailed breakdown of usage by repositories within an organization, click an organization name to display the "Global code security settings" for the organization.

    On the "Global code security settings" settings page, scroll to the "GitHub Advanced Security repositories" section to see a detailed breakdown of usage by repository for this organization, see Managing your paid use of Advanced Security.

Downloading Advanced Security license usage information

You can download a CSV file with GitHub Advanced Security license usage information at both the level. The CSV file contains information about each Advanced Security license that is in use, including:

  • The username of the person using the GitHub Advanced Security license
  • The GitHub Advanced Security-enabled repositories where commits were made
  • The organizations that people using licenses belong to
  • The most recent commit dates and associated email addresses

You can use this information for insights into your Advanced Security usage, such as which members of your enterprise are using a license or how licenses are being consumed across your organizations.

You can download a CSV report of license usage through the GitHub user interface or the REST API.

Downloading license usage information from the UI

  1. In the top-right corner of GitHub Enterprise Server, click your profile photo, then click Enterprise settings.

    Screenshot of the dropdown menu shown when you click the profile photo on GitHub Enterprise Server. The "Enterprise settings" option is outlined.

  2. Under Settings, click License.

  3. Under "GitHub Advanced Security," click CSV report.

    Screenshot of the licensing screen. The "CSV Report" button is highlighted with an orange outline.

Downloading Advanced Security license usage information through the REST API

You can retrieve Advanced Security usage information via the billing API.

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