Holidays Service

1. Authentication
Parameter
Description
Value

Authentication Method

Required

Access Key

The access key for the request sender. This parameter identifies the account that will be charged for the request. Access keys can be created in the API control panel. Additionally, the API control panel allows to set certain preferences and restrictions per access key.

*

Example: NYczonwTxv

Required

Secret Key

The secret key associated with the access key.

*

Example: x4whvXnG7cCOBiNBoi1r

Required

Expiry Date

The date and time at which the signature for this request will expire. After this time, the request will be declined. This time stamp cannot be more than 24 hours ahead from the time the request is submitted.

*

Example: 2011-04-15T15:43:46Z

Required

Signature

The signature for the request. The signature is created by applying the HMAC-SHA1 (RFC 2104) function to a concatenation of the access key, the called service name and the signature timestamp or expiry timestamp. The resulting data has to be encoded with the Base64 method.

*

Example: 4KvntdTApUC2MO6FJQqwYeVxQX0=

2. Service Parameters
Parameter
Description
Value
Required

Country

Specify the country for which you would like to retrieve the list of holidays.

*
Trial package: available data
Required

Year

The year for which the holidays should be retrieved.

*

Holiday types

Holiday types which should be returned. To combine multiple types, either separate them with commas or repeat the parameter with a different value. A negation can be expressed by prefixing the value with a tilde (~) character. Values are combined in the order they are supplied.

Example: all,~un (return all holidays, but no UN events)

Time zone info

Add time zone information under the date object.

Verbose time

Adds verbose time specification to all ISO 8601 time stamps.

3. Output Options
Parameter
Description
Value

Output Format

The services support to output data in different formats. By default, the answer is returned in JSON format, but it is also possible to request the data in JSON-P, Javascript, XML or plain text format. While XML and JSON/Javascript formats are supported by all services, plain text is only supported by specific services. Please see the documentation for the individual services for more details. Note that the plain text output method may also include a CSV representation.

Callback Method

This parameter switches the output method to JSON-P and allows to specify the method name that should receive the result. You can choose this identifier freely to suit your needs.

Example: parseResponse

Variable Name

This parameter switches the output method to Javascript and allows to specify the variable name the output data should be assigned to.

Example: o

Prettyprint

Set this parameter to 1 to receive the XML or JSON/Javascript output with line breaks and indentations. If set to zero, or unset, the output will be returned in compact form. This parameter is not applicable to the plain text output format.

4. Result 
Click the Go!-button to submit a request.
Terms & Conditions Copyright © Time and Date AS
All data supplied by timeanddate.com