---
title: "Get an issued license"
method: GET
path: "/licenses/{licenseId}"
tags: ["License Portal"]
---

# Get an issued license

`GET /licenses/{licenseId}`

## Request

- Base URL: `https://api.example.com/api/license-portal/v1`
- URL: `https://api.example.com/api/license-portal/v1/licenses/{licenseId}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sphereon-opensource/apis/license-portal-api/docs/licenses/:licenseId/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `licenseId` string, required

## Response `200`

Issued license.

- IssuedLicenseResponse
  - `licenseId` string, required
  - `requestId` string
  - `status` string, required
  - `claims` LicenseIssuanceRequest, required
    - `schema` string, required
    - `licenseId` string, required
    - `product` string, required
    - `edition` string, required
    - `customerPartyId` string, required
    - `customerName` string, required
    - `softwarePartyId` string, required
    - `installationId` string, required
    - `installationName` string, required
    - `features` string[], required
    - `quotas` LongMap, required
    - `gatePolicy` LicenseGatePolicy
      - `productFeatures` LicenseGateRules
        - `enabled` string[]
        - `disabled` string[]
      - `commands` LicenseGateRules
        - `enabled` string[]
        - `disabled` string[]
    - `validFrom` string, required
    - `expiresAt` string, required
    - `issuedAt` string, required
    - `issuer` string, required
    - `keyId` string, required
    - `profileId` string
    - `recipientKeyId` string
    - `recipientPublicKeyFingerprint` string
    - `licenseRequestId` string
    - `requestArtifactDigest` string
    - `recipientKeyThumbprint` string
    - `installationBaseDomain` string
    - `platformDomainRoots` string[]
    - `statusList` LicenseStatusListReference
      - `uri` string, required
      - `index` integer, required
      - `purpose` string, required
      - `tokenFormat` string, required
      - `listId` string
    - `checkInterval` string
    - `checkGrace` string
    - `stapledStatusListToken` string
    - `metadata` StringMap, required
  - `artifact` IssuedLicenseArtifactResponse, required
    - `format` string, required
    - `keyId` string, required
    - `digest` string, required
    - `issuedAt` string, required
    - `platformCertificate` ImportedPlatformLicenseRequestCertificate
      - `pem` string
      - `derBase64` string
      - `chainBase64` string[]
      - `fingerprint` string
  - `revokedAt` string
  - `revokedBy` string
  - `revocationReason` string
  - `tenantId` string

## Changes

- **2026-06-26** `3fb109562164`: 1 breaking
  - removed the required property `artifact/token` from the response with the `200` status

[Operation history](https://skmtc.dev/sphereon-opensource/apis/license-portal-api/changes/licenses/:licenseId/get.md)

---

[API](https://skmtc.dev/sphereon-opensource/apis/license-portal-api.md) - [All operations](https://skmtc.dev/sphereon-opensource/apis/license-portal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sphereon-opensource/apis/license-portal-api/revisions/f45b2d91505a?raw)