Skip to main content

This version of GitHub Enterprise Server was discontinued on 2025-04-03. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise Server. For help with the upgrade, contact GitHub Enterprise support.

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

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 "Security & analysis" for the organization.

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.