# Validates announcement start and end times against the server timezone

Validates the proposed announcement schedule times by checking them against the server's configured timezone. Accepts 'startTime', 'endTime', 'lapTime', and 'isMultipleTime' query parameters. Returns whether the time window is valid.

## Endpoint

GET `/dcapi/tools/announcement/validateTime`

## Request

### Request URL

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

### Scope

`DesktopCentralCloud.Tools.READ`

### Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

### Request Parameters

#### Request Headers

- **Accept** `string` — Mandatory: `application/json`

#### Query Parameters

- **startTime** `string` — Optional
  - Announcement start time string. Validated against the server's configured timezone
- **endTime** `string` — Optional
  - Announcement end time string. Must be after startTime. Validated against the server's configured timezone
- **lapTime** `string` — Optional
  - Interval time between repeated announcement displays within the schedule window
- **isMultipleTime** `boolean` — Optional
  - Set to true when the announcement should repeat multiple times within the schedule window

### Sample Request

```curl
curl --request GET \
  --url https://appdomains/dcapi/tools/announcement/validateTime \
  --header 'Accept: application/json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response

### Response Parameters

#### HTTP Code 200

##### Response Body — application/json

`JSON Object`

- **isValid** `boolean`
  - true if the provided start and end times form a valid schedule window
- **serverTimezone** `string`
  - Server timezone identifier used for time validation (e.g., America/New_York)
- **parsedStartTime** `long`
  - Epoch timestamp of the parsed start time in server timezone
- **parsedEndTime** `long`
  - Epoch timestamp of the parsed end time in server timezone

### Sample Response: HTTP 200

```json
{
  "isValid": true,
  "serverTimezone": "America/New_York",
  "parsedStartTime": 1711400000000,
  "parsedEndTime": 1711436000000
}
```

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