---
title: "List enterprise consumed licenses"
method: GET
path: "/enterprises/{enterprise}/consumed-licenses"
tags: ["enterprise-admin"]
---

# List enterprise consumed licenses

`GET /enterprises/{enterprise}/consumed-licenses`

Lists the license consumption information for all users, including those from connected servers, associated with an enterprise.

The authenticated user must be an enterprise admin to use this endpoint.

OAuth app tokens and personal access tokens (classic) need the `read:enterprise` scope to use this endpoint.

## Path parameters

- `enterprise` string, required

## Query parameters

- `per_page` integer
- `page` integer

## Response `200`

Consumed Licenses Response

- GetConsumedLicenses — A breakdown of the licenses consumed by an enterprise.
  - `total_seats_consumed` integer
  - `total_seats_purchased` integer
  - `users` object[]
    - `github_com_login` string
    - `github_com_name` string, nullable
    - `enterprise_server_user_ids` string[]
    - `github_com_user` boolean
    - `enterprise_server_user` boolean, nullable
    - `visual_studio_subscription_user` boolean
    - `license_type` string
    - `github_com_profile` string, nullable
    - `github_com_member_roles` string[]
    - `github_com_enterprise_roles` string[] — All enterprise roles for a user.
    - `github_com_verified_domain_emails` string[]
    - `github_com_saml_name_id` string, nullable
    - `github_com_orgs_with_pending_invites` string[]
    - `github_com_two_factor_auth` boolean, nullable
    - `enterprise_server_emails` string[]
    - `visual_studio_license_status` string, nullable
    - `visual_studio_subscription_email` string, nullable
    - `total_user_accounts` integer

---

[API](https://skmtc.net/github/apis/github-v3-rest-api-2.md) · [All operations](https://skmtc.net/github/apis/github-v3-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/github/github-v3-rest-api-2/versions/8ae6d0c8716e/schema)