---
title: "List licenses"
method: GET
path: "/api/v2/saas-management/application-licenses"
tags: ["SaaS App Management"]
---

# List licenses

`GET /api/v2/saas-management/application-licenses`

## Request

- Base URL: `https://console.jumpcloud.com`
- URL: `https://console.jumpcloud.com/api/v2/saas-management/application-licenses`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/docs/api/v2/saas-management/application-licenses/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a paginated list of licenses for an organization

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

List of licenses

- JumpcloudHttpSaasAppManagementPublicAPILicenseListResponse
  - `results` JumpcloudHttpSaasAppManagementPublicAPILicenseListResponseItem[]: List of licenses
    - `id` string: Contract ID
    - `currency` string: Contract currency
    - `licenses` object: Application licenses counts summary
      - `total` integer: Total licenses count
      - `assigned` integer: Assigned licenses count
      - `unassigned` integer: Unassigned licenses count
    - `costs` object: Application licenses costs summary
      - `estimated_cost` number: Total yearly cost of all licenses to estimate yearly contract cost
      - `contract_cost` number: Total yearly cost of contract
      - `saving_opportunity_cost` number: Total yearly cost saving potential from unassigned licenses
    - `renewal_date` string: Next renewal date of the application contract
    - `contract_term` 'MONTHLY_TERM' | 'YEARLY_TERM' | 'FREE_TERM': License contract renewal period term
  - `totalCount` integer: Total number of licenses available

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal server error
- `default`: Generic error response

---

[API](https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api.md) - [All operations](https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/revisions/f396d9271b46?raw)