# Retrieve full license details including edition, counts, and add-ons

Returns the complete license state -- edition, expiry, resource counts, and add-on details. For a lighter endpoint-only view, use [Get License Endpoints](https://www.manageengine.com/products/desktop-central/help/api/cloud/get-license-endpoints.html).

## Endpoint

`GET /dcapi/license`

## Request URL

`https://`[*{serverurl}*](https://www.manageengine.com/products/desktop-central/help/api/cloud/oauth-authentication-endpoint-domain.html)`/dcapi/license`

## Scope

`DesktopCentralCloud.Admin.READ`

## Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

| Name | Type | Required | Value |
|---|---|---|---|
| Accept | string | Mandatory | `application/licenseDetails.v1+json` |

## Sample Request

```curl
curl --request GET \
  --url https://appdomains/dcapi/license \
  --header 'Accept: application/licenseDetails.v1+json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP code 200

Response Body: `application/json`

| Field | Type | Description |
|---|---|---|
| isLicensePromoted | boolean | True when a promotional trial is active. |
| trialDaysLeft | long | Days remaining in the promotional trial. Present only when isLicensePromoted is true. |
| payNow | string | CTA text for purchasing the promoted license. Present only when isLicensePromoted is true. |
| downgradeNow | string | CTA text for reverting to the previous edition. Present only when isLicensePromoted is true. |
| Action | string | Downgrade action identifier. Present only when isLicensePromoted is true. |
| licenseEdition | string | License edition display name. |
| productName | string | Product display name. |
| buildNumber | string | Build-number string. |
| licensedTo | string | Company or username the license is registered to. |
| licenseExpiryDate | string | Formatted expiry date. Absent for free/trial licenses. |
| evaluationDaysLeft | string | Days remaining for trial licenses. Absent for registered/free licenses. |
| subscriptionFrequency | string | Subscription renewal frequency. Values: `YEARLY` or `MONTHLY`. |
| addonDetails | JSON Object | Add-on enablement status and detailed list. |
| users | JSON Object | Technician/user license counts. |
| endpoints | JSON Object | Endpoint license counts with split breakdown. |
| computers | JSON Object | Computer license counts. Present when endpoints key is not used. |
| servers | JSON Object | Server license counts with split breakdown. |
| storageSpace | JSON Object | Storage add-on usage. |
| smsCredits | JSON Object | SMS credit counts. |
| osdSystems | JSON Object | Add-on details. |
| arwAddon | JSON Object | Anti-Ransomware add-on details. |
| ngavAddon | JSON Object | Add-on details. |
| blmAddon | JSON Object | BitLocker Management add-on details. |
| vmpAddon | JSON Object | Add-on details. |
| bspAddon | JSON Object | Browser Security Plus add-on details. |
| acpAddon | JSON Object | Add-on details. |
| dcpAddon | JSON Object | Add-on details. |
| dlpAddon | JSON Object | Add-on details. |
| edrAddon | JSON Object | EDR add-on details. |
| eaAddon | JSON Object | Endpoint Analytics add-on details. |

### Sample Response: HTTP 200

Registered license with individual add-ons and shortfall

```json
{
  "bspAddon": {
    "devices": {
      "purchased": 100,
      "managed": 40,
      "isShortfall": false
    },
    "isAddonTrial": false,
    "status": true
  },
  "dlpAddon": {
    "devices": {
      "purchased": 100,
      "managed": 45,
      "isShortfall": false
    },
    "isAddonTrial": false,
    "status": true
  },
  "endpoints": {
    "purchased": 250,
    "managed": 200,
    "viewUrl": "/webclient#/uems/agent/som/computers?deviceType=2"
  },
  "ngavAddon": {
    "devices": {
      "purchased": 100,
      "managed": 60,
      "isShortfall": false
    },
    "isAddonTrial": false,
    "status": true
  },
  "subscriptionFrequency": "YEARLY",
  "blmAddon": {
    "devices": {
      "purchased": 100,
      "managed": 80,
      "isShortfall": false
    },
    "isAddonTrial": false,
    "status": true
  },
  "buildNumber": "11.3.2423.0",
  "productName": "Endpoint Central Cloud",
  "licensedTo": "Acme Corporation",
  "users": {
    "purchased": 5,
    "managed": 3,
    "viewUrl": "/webclient#/uems/admin/user-administration/users"
  },
  "acpAddon": {
    "devices": {
      "purchased": 100,
      "managed": 65,
      "isShortfall": false
    },
    "isAddonTrial": false,
    "status": true
  },
  "isLicensePromoted": false,
  "dcpAddon": {
    "devices": {
      "purchased": 100,
      "managed": 55,
      "isShortfall": false
    },
    "isAddonTrial": false,
    "status": true
  },
  "smsCredits": {
    "purchased": 100,
    "managed": 50
  },
  "osdSystems": {
    "servers": {
      "purchased": 10,
      "managed": 5,
      "isShortfall": false
    },
    "osdComputers": {
      "purchased": 50,
      "managed": 40,
      "isShortfall": false
    },
    "devices": {
      "purchased": 50,
      "managed": 40,
      "isShortfall": false
    },
    "osdLicenseEdition": "Enabled",
    "osdServers": {
      "purchased": 10,
      "managed": 5,
      "isShortfall": false
    },
    "isAddonTrial": false,
    "status": true
  },
  "licenseEdition": "Enterprise Edition - Registered Version",
  "licenseExpiryDate": "Dec 31, 2030",
  "servers": {
    "purchased": 10,
    "managed": 8,
    "viewUrl": "/webclient#/uems/agent/som/computers?deviceType=1"
  },
  "vmpAddon": {
    "devices": {
      "purchased": 100,
      "managed": 90,
      "isShortfall": false
    },
    "isAddonTrial": false,
    "status": true
  },
  "addonDetails": {
    "isBasicTrainingEnabled": false,
    "isPremiumSupportEnabled": false,
    "isMultiLangEnabled": false
  },
  "arwAddon": {
    "devices": {
      "shortfallMessage": "You have 20 more endpoints than purchased.",
      "purchased": 100,
      "managed": 120,
      "isShortfall": true
    },
    "isAddonTrial": false,
    "status": true
  },
  "storageSpace": {
    "purchased": 10,
    "managed": "4.76"
  },
  "eaAddon": {
    "devices": {
      "purchased": 100,
      "managed": 70,
      "isShortfall": false
    },
    "isAddonTrial": false,
    "status": true
  },
  "edrAddon": {
    "devices": {
      "purchased": 100,
      "managed": 50,
      "isShortfall": false
    },
    "isAddonTrial": true,
    "status": true
  }
}
```

### HTTP code 500

Response Body: `application/json`

| Field | Type | Description |
|---|---|---|
| error_code | integer | Error code. `1001` indicates an unexpected failure while fetching license details. |
| error_description | string | Human-readable error message describing the failure. |

### Sample Response: HTTP 500

Unexpected server error

```json
{
  "error_description": "An internal error occurred while processing the request.",
  "error_code": 1001
}
```

## Rate Limit

**Duration:** 1 minute | **Threshold:** 30 | **Lock period:** 5 minutes

Duration - Time window for the threshold.  
Threshold - Number of API calls allowed within the specified duration.  
Lock Period - Wait time before consecutive API requests.