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.

Endpoints

get /dcapi/license

Copy full URL

Request URL

https://{server-hostname}:8383/dcapi/license

Scope

Admin.READCopied!

Header

Authorization: d92d4xxxxxxxxxxxxx15f52

Request Parameters

- Request Headers

AcceptstringMandatory

application/licenseDetails.v1+jsonCopied!

Sample Request

Curl

Java

Python

Deluge

PowerShell

Copied!

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

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.io.IOException;
import java.net.http.HttpTimeoutException;

public class Main {
  public static void main(String[] args) {

    HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://appdomain/dcapi/license"))
        .header("Accept", "application/licenseDetails.v1+json")
        .header("Authorization", " d92d4xxxxxxxxxxxxx15f52")
        .method("GET", HttpRequest.BodyPublishers.noBody())
        .build();
    HttpResponse response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.body());
  
  }
}

import http.client

conn = http.client.HTTPSConnection("appdomain")

headers = {
    'Accept': "application/licenseDetails.v1+json",
    'Authorization': " d92d4xxxxxxxxxxxxx15f52"
    }

conn.request("GET", "/dcapi/license", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))


    headersMap = Map();
    headersMap.put("Accept", "application/licenseDetails.v1+json");

    response = invokeUrl
    [
        url: "https://appDomain/dcapi/license"
        type: GET
        headers: headersMap
        connection: connection_name
    ]

    info response;

$headers=@{}
$headers.Add("Accept", "application/licenseDetails.v1+json")
$headers.Add("Authorization", " d92d4xxxxxxxxxxxxx15f52")
$response = Invoke-WebRequest -Uri 'https://appdomain/dcapi/license' -Method GET -Headers $headers

Response Parameters

- HTTP code 200

Response Body - application/json

JSON Object

Hide Sub-Attributes

isLicensePromotedboolean

True when a registered license is running a higher-edition promotional trial. When true, additional keys trialDaysLeft, payNow, downgradeNow, and Action are included in the response.

trialDaysLeftlong

Days remaining in the promotional trial. Included only when isLicensePromoted is true.

payNowstring

CTA text for purchasing the promoted license (e.g. 'Purchase License'). Included only when isLicensePromoted is true.

downgradeNowstring

CTA text for reverting to the previous edition (e.g. 'Retain Enterprise'). Included only when isLicensePromoted is true.

Actionstring

Action identifier for the downgrade button. Value is always 'Downgrade'. Included only when isLicensePromoted is true.

licenseEditionstring

Localized license edition display message (e.g. 'Enterprise Edition - Registered Version', 'Free', 'Security Edition - Trial Version'). Varies by license type and plan.

productNamestring

Product display name (e.g. 'Endpoint Central Cloud').

buildNumberstring

Build-number string (e.g. 11.3.2423.0).

licensedTostring

Company name for registered licenses; username for free/trial licenses.

licenseExpiryDatestring

Formatted expiry date for registered licenses (e.g. 'Dec 31, 2030' or 'Never'). Absent for free and trial licenses.

evaluationDaysLeftstring

String-formatted days remaining for trial licenses (e.g. '22'). Absent for registered and free licenses.

subscriptionFrequencystring

Subscription renewal frequency. Values: 'YEARLY' or 'MONTHLY'.

addonDetailsJSON Object

Add-on enablement status and detailed list including multi-language pack, training, and premium support.

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

Endpoints

Request URL

Scope

Header

Request Parameters

- Request Headers

Sample Request

Response Parameters

- HTTP code 200

Response Body - application/json

- HTTP code 500

Response Body - application/json

Possible Response Codes

Sample Response: HTTP 200

Sample Response: HTTP 500