Skip to main content

Viewing your GitHub Advanced Security usage

You can view usage of GitHub Advanced Security for your enterprise.

Who can use this feature

Enterprise owners can view usage for GitHub Advanced Security.

GitHub Advanced Security is available for enterprise accounts on GitHub Enterprise Cloud and GitHub Enterprise Server. Some features of GitHub Advanced Security are also available for public repositories on GitHub.com. For more information, see "GitHub’s products."

About licenses for GitHub Advanced Security

Each license for GitHub Advanced Security specifies a maximum number of licenses that can use these features. Periodically you should check that your use is within your license capacity. For more information, see "About billing for GitHub Advanced Security."

Viewing GitHub Advanced Security license usage for your enterprise account

You can view the enterprise account's current license limits and usage.

  1. In the top-right corner of GitHub.com, click your profile photo, then click Your enterprises. "Your enterprises" in drop-down menu for profile photo on GitHub Enterprise Cloud

  2. In the list of enterprises, click the enterprise you want to view.

  3. In the enterprise account sidebar, click Settings.

  4. In the left sidebar, click Enterprise licensing. "Enterprise licensing" tab in the enterprise account settings sidebar

    The "GitHub Advanced Security" section shows details of the current usage. GitHub Advanced Security in enterprise licensing settings If you run out of licenses, the section will be red and show "Limit exceeded." You should either reduce your use of GitHub Advanced Security or purchase more licenses. For more information, see "About billing for GitHub Advanced Security" and "Managing your GitHub Advanced Security licensing." GitHub Advanced Security in enterprise licensing settings showing "Limit exceeded"

  5. Optionally, to see a detailed breakdown of usage per organization, in the enterprise account sidebar, click Billing. In the “GitHub Advanced Security” section, you can see a summary of your current license usage, as well as the number of committers and unique committers for each organization. The organizations in the billing table are sorted by the highest number of unique committers in descending order.

  6. Optionally, display the security and analysis settings for an organization.

    • Click the name of the organization.

    • On the "Code security & analysis" settings page, scroll to the "GitHub Advanced Security repositories" section to see an overview of your organization's license usage, as well as a detailed breakdown of usage by repository for this organization.

      For more information, see "Managing security and analysis settings for your organization."

Downloading GitHub Advanced Security license usage information

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

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

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

You can download the Advanced Security license usage CSV through the GitHub Enterprise Cloud user interface or the REST API.

Downloading Advanced Security license usage information through the UI

At the repository-level

  1. In the top right corner of GitHub.com, click your profile photo, then click Your organizations.

    Screenshot of the dropdown menu under @octocat's profile picture. "Your organizations" is outlined in dark orange.

  2. Next to the organization, click Settings.

  3. In the "Security" section of the sidebar, click Code security and analysis.

  4. In the "GitHub Advanced Security repositories" section, next to the repository you want usage information for, select , then click Download CSV report. Screenshot of the committers by repository table. The horizontal kebab icon and "Download CSV report" button are highlighted with an orange outline.

At the organization-level

  1. In the top right corner of GitHub.com, click your profile photo, then click Your organizations.

    Screenshot of the dropdown menu under @octocat's profile picture. "Your organizations" is outlined in dark orange.

  2. Next to the organization, click Settings.

  3. In the "Access" section of the sidebar, click Billing and plans.

  4. Underneath "GitHub Advanced Security," next to "Committers", click CSV report.

At the enterprise-level

  1. In the top-right corner of GitHub.com, click your profile photo, then click Your enterprises. "Your enterprises" in drop-down menu for profile photo on GitHub Enterprise Cloud

  2. In the list of enterprises, click the enterprise you want to view.

  3. In the enterprise account sidebar, click Settings.

  4. In the left sidebar, click Enterprise licensing. "Enterprise licensing" tab in the enterprise account settings sidebar

  5. Under "GitHub Advanced Security," click the Manage dropdown and then click Download report. Download button for enterprise-level data

Downloading Advanced Security license usage information through the REST API

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

For organization-level data, use the /orgs/{org}/settings/billing/advanced-security endpoint. For more information, see "Billing" in the GitHub REST API documentation.

For enterprise-level data, use the /enterprises/{enterprise}/settings/billing/advanced-security endpoint. For more information, see "GitHub Enterprise administration" in the GitHub REST API documentation.