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

## Endpoints

GET `/dcapi/tools/announcement/validateTime`

## Request URL

`https://{server-hostname}:8383/dcapi/tools/announcement/validateTime`

## Scope

`Tools.READ`

## Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

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

## Sample Request

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

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

## Possible Response Codes

- **200** `HTTP code`

## Sample Response: HTTP 200

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

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