# Retrieve evaluation/trial status for the current organization

Returns the evaluation state of the organization -- trial days remaining, license edition, and pricing links.

## Endpoint

`GET /dcapi/license/evaluationDetails`

## Request URL

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

## Scope

`DesktopCentralCloud.Admin.READ`

### Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

- **Accept** `string` **Mandatory**: `application/evaluationDetails.v1+json`

## Sample Request

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

## Response Parameters

### HTTP Code 200

Response body: `application/json`

**JSON Object**

- **evaluationDaysLeft** `long`: Days remaining in the trial/evaluation period. Present only in trial mode.
- **evalMsg** `string`: Localized trial banner message (e.g. 'Explore the product at its best for 22 days.'). Varies by remaining days.
- **priceQuoteMsg** `string`: CTA label for the pricing/quote action (e.g. 'Get Quote', 'Explore Editions'). Present only for admin users.
- **priceQuoteURL** `string`: Relative URL for the pricing/quote page. Present only for admin users.
- **isLicensePromoted** `boolean`: True when the license has been promoted to a higher-edition trial. When true, additional promotion keys are included.
- **evaluationDays** `string`: Days remaining in the promotional trial as a string. Present only when isLicensePromoted is true.
- **evalLicense** `string`: Localized message about the promotional trial state. Present only when isLicensePromoted is true.
- **recommendedPlanName** `string`: The promoted edition name (e.g. 'Security'). Present only when isLicensePromoted is true.
- **buyNow** `string`: CTA label for purchasing the promoted edition. Present only when isLicensePromoted is true.
- **getQuote** `string`: CTA label for getting a quote. Present only when isLicensePromoted is true.
- **downgradeNow** `string`: CTA label for reverting to the previous edition. Present only when isLicensePromoted is true.
- **extendTrial** `string`: CTA label for extending the promotional trial. Present only when the trial has not yet been extended.
- **subscription** `string`: Label for the subscription page link. Present only when isLicensePromoted is true.
- **subscriptionUrl** `string`: Relative URL to the subscription page. Present only when isLicensePromoted is true.

### Sample Response: HTTP 200

Organization is in trial mode with 22 days remaining.

```json
{
  "evaluationDaysLeft": 22,
  "priceQuoteMsg": "Get Quote",
  "priceQuoteURL": "/webclient#/uems/admin/subscription",
  "evalMsg": "Explore the product at its best for 22 days."
}
```

License has been promoted to a higher-edition trial -- extendTrial present (trial not yet extended).

```json
{
  "buyNow": "Buy Now",
  "getQuote": "Buy Now",
  "extendTrial": "Extend Trial",
  "subscription": "Subscription",
  "evaluationDays": "22",
  "recommendedPlanName": "Security",
  "downgradeNow": "Retain Current Edition",
  "isLicensePromoted": true,
  "evalMsg": "Try out the Security edition features for 22 more days.",
  "evalLicense": "Promoted Trial",
  "subscriptionUrl": "/webclient#/uems/admin/subscription"
}
```

Promoted trial already extended once -- extendTrial key absent.

```json
{
  "buyNow": "Buy Now",
  "getQuote": "Buy Now",
  "subscription": "Subscription",
  "evaluationDays": "10",
  "recommendedPlanName": "Security",
  "downgradeNow": "Retain Current Edition",
  "isLicensePromoted": true,
  "evalMsg": "Try out the Security edition features for 10 more days.",
  "evalLicense": "Promoted Trial",
  "subscriptionUrl": "/webclient#/uems/admin/subscription"
}
```

Registered or free edition -- not in trial, not promoted. Empty response.

```json
{}
```

### HTTP Code 500

Response body: `application/json`

**JSON Object**

- **error_code** `integer`: Error code. 1001 indicates an unexpected failure while retrieving evaluation details.
- **error_description** `string`: Human-readable error message describing the failure.

### Sample Response: HTTP 500

Unexpected server error while fetching evaluation details.

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

## Rate Limits

![](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

**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.