# 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

### Request URL

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

### Scope

`Admin.READ`

### Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

### Request Parameters

#### Request Headers

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

### Sample Request

```curl
curl --request GET \
  --url https://appdomain/dcapi/license/evaluationDetails \
  --header 'Accept: application/evaluationDetails.v1+json' \
  --header 'Authorization:  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.

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

### Possible Response Codes

- **200** — HTTP code
- **500** — HTTP code

### 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
{}
```

### 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 Limit

![](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.