Skip to main content

Viewing your GitHub Advanced Security usage

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

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 3.0 or higher. For more information about upgrading your GitHub Enterprise Server instance, see "About upgrades to new releases" and refer to the Upgrade assistant to find the upgrade path from your current release version.

About licenses for GitHub Advanced Security

Each license for GitHub Advanced Security specifies a maximum number of accounts, or seats, 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."

You can calculate how many additional seats will be used if you enable GitHub Advanced Security for more organizations and repositories with the site admin dashboard. For more information, see "Site admin dashboard."

Viewing GitHub Advanced Security license usage for your enterprise account

You can check how many seats your license includes and how many of them are currently used.

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

  2. In the enterprise account sidebar, click Settings. Settings tab in the enterprise account sidebar

  3. In the left sidebar, click License. "License" tab in the enterprise account settings sidebar

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

  4. Optionally, click the name of an organization where you are an owner to display the security and analysis settings for the organization. Owned organization in GitHub Advanced Security section of enterprise billing settings

  5. On the "Security & analysis" settings page, scroll to the "GitHub Advanced Security repositories" section to see a detailed breakdown of usage by repository for this organization. GitHub Advanced Security repositories section 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 seat that is in use, including:

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

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

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

Downloading Advanced Security license usage information through the UI

At the organization-level

  1. In the top right corner of GitHub Enterprise Server, click your profile photo, then click Your organizations. Your organizations in the profile menu

  2. Next to the organization, click Settings. The settings button

  3. In your organization's Settings sidebar, click Billing & plans. Billing settings

  4. Underneath "GitHub Advanced Security," click next to "Committers." Download button for organization-level data

At the enterprise-level

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

  2. In the enterprise account sidebar, click Settings. Settings tab in the enterprise account sidebar

  3. In the left sidebar, click License. "License" tab in the enterprise account settings sidebar

  4. Under "GitHub Advanced Security," click next to "Commiters." 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 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.