Upcoming holidays
GET
/v1/holidays/upcomingPublic holidays from today for the next 30 days (or any number up to a year), with how many days away each is.
On every plan, Free includedKey requiredJSON or CSVCached until the next release
Parameters
| Name | Type | Description |
|---|---|---|
| countryoptional | string query | One or more ISO codes, comma separated e.g. CL,BA,AT |
| daysoptional | integer query | How many days ahead, 1 to 365 (30 when left out) e.g. 30 |
Request
# Public holidays in the coming days
curl "https://api.tourismapi.com/v1/holidays/upcoming?country=TH" \
-H "X-API-Key: $TOURISM_API_KEY"const res = await fetch("https://api.tourismapi.com/v1/holidays/upcoming?country=TH", {
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/upcoming?country=TH",
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/upcoming?country=TH");
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"]);
Example response
{
"meta": {
"request_id": "req_86acc455b5",
"data_as_of": "2026-11-07T04:51:48Z",
"count": 6,
"from": "2026-11-07",
"days": 30
},
"data": [
{
"country": "TH",
"date": "2026-12-05",
"name": "HM King Bhumibol Adulyadej the Great's Birthday",
"local_name": "วันคล้ายวันเฉลิมพระชนมพรรษาพระบาทสมเด็จพระบรมชนกาธิเบศร มหาภูมิพลอดุลยเดชมหาราช บรมนาถบพิตร",
"national": true,
"in_days": 28
},
{
"country": "TH",
"date": "2026-12-05",
"name": "National Day",
"local_name": "วันชาติ",
"national": true,
"in_days": 28
},
{
"country": "TH",
"date": "2026-12-05",
"name": "National Father's Day",
"local_name": "วันพ่อแห่งชาติ",
"national": true,
"in_days": 28
}
]
}Response fields
| Field | Type | Example |
|---|---|---|
| country | string | TH |
| date | string | 2026-12-05 |
| name | string | HM King Bhumibol Adulyadej the Great's Birthday |
| local_name | string | วันคล้ายวันเฉลิมพระชนมพรรษาพระบาทสมเด็จพระบรมชนกาธิเบศร มหาภูมิพลอดุลยเดชมหาราช บรมนาถบพิตร |
| national | boolean | true |
| in_days | number | 28 |