---
title: "List top-level license definitions"
method: GET
path: "/api/v1/license-definitions"
tags: ["License Definitions"]
---

# List top-level license definitions

`GET /api/v1/license-definitions`

## Request

- Base URL: `https://brew.marketbrew.ai/api/v1`
- URL: `https://brew.marketbrew.ai/api/v1/api/v1/license-definitions`
- Auth: API key in header `API-Key`

## Response `200`

Top-level license-definition trees

- LicenseDefinitionDTO[]
  - `id` integer
  - `name` string
  - `showAtTopLevel` boolean
  - `published` boolean
  - `parents` LicenseDefinitionSummary[]
    - `id` integer
    - `name` string
  - `children` LicenseDefinitionDTO[]
  - `websites` WebsiteSummary[]
    - `websiteId` integer
    - `serverHost` string
  - `activationDate` string, date
  - `deactivationDate` string, date
  - `websiteCardinality` CardinalityDefinitionDTO
    - `mode` 'USE_GIVEN_VALUE_INPUT_DISABLED' | 'GIVEN_VALUE_AS_DEFAULT_INPUT_ENABLED' | 'INPUT_REQUIRED' | 'VALUE_IS_NULL_INPUT_DISABLED'
    - `value` CardinalityDTO
      - `type` 'SOFT' | 'HARD' | 'UNLIMITED' | 'INFERRED' | 'NONE', required
      - `limit` integer
  - `feature` string
  - `licenseType` 'PERFORMANCE_PLAN' | 'ENTERPRISE_PLAN' | 'LICENSE_PACKAGE' | 'FEATURE_PLAN'
  - `baseEntitlementLimit` EntitlementLimitDefinitionDTO
    - `mode` 'USE_GIVEN_VALUE_INPUT_DISABLED' | 'GIVEN_VALUE_AS_DEFAULT_INPUT_ENABLED' | 'INPUT_REQUIRED' | 'VALUE_IS_NULL_INPUT_DISABLED'
    - `value` EntitlementLimitDTO
      - `months` integer
      - `cardinality` CardinalityDTO, required
        - `type` 'SOFT' | 'HARD' | 'UNLIMITED' | 'INFERRED' | 'NONE', required
        - `limit` integer
  - `accessChannelEntitlementLimitsSetPromptEdit` boolean
  - `accessChannelEntitlementLimits` AccessChannelEntitlementLimitDefinitionDTO[]
    - `forAccessChannel` 'UI' | 'API' | 'DOODAD' | 'SYSTEM' | 'SCHEDULE'
    - `entitlementLimit` CardinalityDefinitionDTO
      - `mode` 'USE_GIVEN_VALUE_INPUT_DISABLED' | 'GIVEN_VALUE_AS_DEFAULT_INPUT_ENABLED' | 'INPUT_REQUIRED' | 'VALUE_IS_NULL_INPUT_DISABLED'
      - `value` CardinalityDTO
        - `type` 'SOFT' | 'HARD' | 'UNLIMITED' | 'INFERRED' | 'NONE', required
        - `limit` integer

---

[API](https://skmtc.dev/marketbrew/apis/market-brew-api-documentation.md) · [All operations](https://skmtc.dev/marketbrew/apis/market-brew-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/marketbrew/apis/market-brew-api-documentation/revisions/11e3674a43d7?raw)