---
title: "Get the installed license."
method: GET
path: "/api/systems/license"
tags: ["Systems"]
---

# Get the installed license.

`GET /api/systems/license`

## Request

- Base URL: `https://[tenant_id].logto.app`
- URL: `https://[tenant_id].logto.app/api/systems/license`
- Auth: OAuth 2 (client credentials, token URL `/oidc/token`, scopes: `all`)

Get the license installed on this self-hosted deployment, i.e. the plan it grants, the entitlements it unlocks, its expiration, and its refresh/grace status. The license key itself is never returned. Returns 404 when no license is installed, and 501 on Logto Cloud.

## Response `200`

The installed license.

- object
  - `plan` 'self-hosted-pro' | 'self-hosted-enterprise', required
  - `env` 'production' | 'non-production', required
  - `quota` object, required
    - `hideLogtoBranding` boolean, required
    - `bringYourUi` boolean, required
    - `idpInitiatedSso` boolean, required
    - `consoleCollaboration` boolean, required
    - `mandatoryMfa` boolean, required
    - `hostedEmail` boolean, required
    - `samlApplicationsLimit` number, nullable, required
  - `expiresAt` string, required
  - `installedAt` string, required
  - `lastRefreshedAt` string, required
  - `graceEndsAt` string, required
  - `refusalReason` string

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: No license is installed on this deployment.
- `501`: Licenses are only available on self-hosted deployments.

## Changes

- **2026-10-13** `45e9f74f55c3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/logto/apis/logto-api-references/changes/api/systems/license/get.md)

---

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