Documentation / Context / 77 of 91

Long weekends

GET/v1/holidays/long-weekends/{iso}

Every break of three days or more in a year that a national holiday makes with the weekend, and each break one day of leave would make longer, with the date to take off. Countries whose weekend falls on other days are counted on their own weekend.

On every plan, Free includedKey requiredJSON or CSVCached until the next release

Parameters

Name	Type	Description
isorequired	string path	ISO 3166 two-letter country code e.g. CL
yearoptional	integer query	Calendar year e.g. 2026

Request

# Long weekends, and the single days off that make longer breaks
curl "https://api.tourismapi.com/v1/holidays/long-weekends/CL" \
  -H "X-API-Key: $TOURISM_API_KEY"

const res = await fetch("https://api.tourismapi.com/v1/holidays/long-weekends/CL", {
  headers: { "X-API-Key": process.env.TOURISM_API_KEY }
});
if (!res.ok) throw new Error(`Tourism API ${res.status}`);
const { meta, data } = await res.json();
console.log(meta.data_as_of, data);

import os, requests

r = requests.get(
    "https://api.tourismapi.com/v1/holidays/long-weekends/CL",
    headers={"X-API-Key": os.environ["TOURISM_API_KEY"]},
    timeout=10,
)
r.raise_for_status()
body = r.json()
print(body["meta"]["data_as_of"], body["data"])

$ch = curl_init("https://api.tourismapi.com/v1/holidays/long-weekends/CL");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ["X-API-Key: " . getenv("TOURISM_API_KEY")],
]);
$body = json_decode(curl_exec($ch), true);
print_r($body["data"]);

Your API key

Ready

Example response

{
    "meta": {
        "request_id": "req_465cbb467b",
        "data_as_of": "2026-10-21T17:42:32Z",
        "count": 10,
        "iso": "CL",
        "year": 2026,
        "weekend": [
            "Saturday",
            "Sunday"
        ],
        "take_off": "empty for a break the calendar gives; one date for a break that one day off makes",
        "counted": "national holidays and the weekend; regional holidays are left out"
    },
    "data": [
        {
            "start": "2026-01-01",
            "end": "2026-01-04",
            "days": 4,
            "holidays": [
                "New Year's Day"
            ],
            "take_off": [
                "2026-01-02"
            ]
        },
        {
            "start": "2026-04-03",
            "end": "2026-04-05",
            "days": 3,
            "holidays": [
                "Good Friday",
                "Holy Saturday"
            ],
            "take_off": []
        },
        {
            "start": "2026-05-01",
            "end": "2026-05-03",
            "days": 3,
            "holidays": [
                "Labor Day"
            ],
            "take_off": []
        }
    ]
}

Response fields

Field	Type	Example
start	string	2026-01-01
end	string	2026-01-04
days	number	4
holidays	array	1 items
take_off	array	1 items