---
title: "List all Licenses (including renewal requests)"
method: GET
path: "/licenses"
tags: ["Licenses"]
---

# List all Licenses (including renewal requests)

`GET /licenses`

## Response `200`

A list of Licenses

- License[]
  - `contractId` string, required
  - `provider` string, required
  - `user` string, required
  - `params` LicenseParams, required
    - `meta` Metadata
      - `data` object
  - `expiresAt` string, date-time, required
  - `licenseNum` integer, required
  - `isExpired` boolean, required
  - `renewalRequests` LicenseRenewalRequest[]
    - `contractId` string, required
    - `provider` string, required
    - `user` string, required
    - `licenseNum` integer, required
    - `licenseFeeAmount` number, required
    - `licenseFeeInstrument` string, required
    - `licenseExtensionDuration` string, required — RelTime representing how long the license should be extended.
    - `prepareUntil` string, date-time, required — The time until the license renewal request can be prepared.
    - `settleBefore` string, date-time, required — The time before which the payment must be settled.
    - `requestedAt` string, date-time, required — The time until the license renewal request can be prepared.
    - `description` string, required
    - `requestId` string, required
    - `allocationCid` string
    - `prepareDeadlinePassed` boolean, required
    - `settleDeadlinePassed` boolean, required

## Other responses

- `401` — Not authenticated
- `500` — An internal server error occurred

## Changes

- **2026-07-17** `8821f8847f2c` — 4 info
  - api tag `Licenses` added
  - added the non-success response with the status `401`
  - added the non-success response with the status `500`
  - removed the non-success response with the status `400`
- **2025-09-03** `f5d5d8701190` — 5 breaking, 11 info
  - removed the required property `items/dso` from the response with the `200` status
  - removed the required property `items/renewalRequests/items/dso` from the response with the `200` status
  - removed the required property `items/renewalRequests/items/isPaid` from the response with the `200` status
  - removed the required property `items/renewalRequests/items/licenseFeeCc` from the response with the `200` status
  - …12 more
- **2025-03-12** `9e528b6996b4` — 1 info
  - added the optional property `items/renewalRequests` to the response with the `200` status
- **2025-02-26** `16506fd5cad4` — 7 info
  - the response property `items/contractId` became required for the status `200`
  - the response property `items/dso` became required for the status `200`
  - the response property `items/expiresAt` became required for the status `200`
  - the response property `items/licenseNum` became required for the status `200`
  - …3 more
- …earlier changes not shown

[Full history](https://skmtc.dev/digital-asset/apis/backend-api/changes/licenses/get.md)

---

[API](https://skmtc.dev/digital-asset/apis/backend-api.md) · [All operations](https://skmtc.dev/digital-asset/apis/backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/digital-asset/backend-api/revisions/8821f8847f2c/schema)