---
title: "GET /api/v1/licenses"
method: GET
path: "/api/v1/licenses"
tags: ["Licensing"]
---

# GET /api/v1/licenses

`GET /api/v1/licenses`

## Request

- Base URL: `https://app.distr.sh` (the document declares no server; this is the origin it was published from)
- URL: `https://app.distr.sh/api/v1/licenses`
- Auth: one of:
  - API key in header `Authorization`
  - HTTP bearer

List all licenses grouped by customer

## Response `200`

OK

- HandlersLicenseResponse[]
  - `applicationEntitlements` TypesApplicationEntitlement[]
    - `application` object
      - `allowAutomaticUpdates` boolean
      - `createdAt` string, date-time
      - `id` string
      - `imageId` string, nullable
      - `name` string
      - `type` string
      - `versioningStrategy` string
      - `versions` TypesApplicationVersion[]
        - `applicationId` string
        - `archivedAt` string, date-time, nullable
        - `chartName` string, nullable
        - `chartType` string, nullable
        - `chartUrl` string, nullable
        - `chartVersion` string, nullable
        - `createdAt` string, date-time
        - `id` string
        - `linkTemplate` string
        - `name` string
        - `resources` TypesApplicationVersionResource[]
          - `applicationVersionId` string
          - `content` string
          - `id` string
          - `name` string
          - `visibleToCustomers` boolean
    - `applicationId` string
    - `autoAddVersionRegex` string, nullable
    - `createdAt` string, date-time
    - `customerOrganization` object, nullable
      - `createdAt` string, date-time
      - `features` string[]
      - `id` string
      - `imageId` string, nullable
      - `name` string
      - `organizationId` string
      - `partnerOrganizationId` string, nullable
    - `customerOrganizationId` string, nullable
    - `expiresAt` string, date-time, nullable
    - `id` string
    - `name` string
    - `registryPassword` string, nullable
    - `registryUrl` string, nullable
    - `registryUsername` string, nullable
    - `versions` TypesApplicationVersion[]
      - `applicationId` string
      - `archivedAt` string, date-time, nullable
      - `chartName` string, nullable
      - `chartType` string, nullable
      - `chartUrl` string, nullable
      - `chartVersion` string, nullable
      - `createdAt` string, date-time
      - `id` string
      - `linkTemplate` string
      - `name` string
      - `resources` TypesApplicationVersionResource[]
        - `applicationVersionId` string
        - `content` string
        - `id` string
        - `name` string
        - `visibleToCustomers` boolean
  - `artifactEntitlements` TypesArtifactEntitlement[]
    - `artifacts` TypesArtifactEntitlementSelection[]
      - `artifactId` string
      - `versionIds` string[]
    - `autoAddVersionRegex` string, nullable
    - `createdAt` string, date-time
    - `customerOrganizationId` string, nullable
    - `expiresAt` string, date-time, nullable
    - `id` string
    - `name` string
  - `customerOrganization` object
    - `createdAt` string, date-time
    - `features` string[]
    - `id` string
    - `imageId` string, nullable
    - `imageUrl` string, nullable
    - `name` string
    - `partnerOrganizationId` string, nullable
  - `licenseKeys` TypesLicenseKey[]
    - `createdAt` string, date-time
    - `customerOrganizationId` string, nullable
    - `description` string, nullable
    - `expiresAt` string, date-time, nullable
    - `id` string
    - `lastRevisedAt` string, date-time, nullable
    - `licenseTemplateId` string, nullable
    - `name` string
    - `notBefore` string, date-time, nullable
    - `payload` string, byte

---

[API](https://skmtc.dev/distr/apis/distr-api-reference.md) - [All operations](https://skmtc.dev/distr/apis/distr-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/distr/apis/distr-api-reference/revisions/7dcafe205f83?raw)