Documentation / Releases / 64 of 75

Release calendar

GET/v1/calendar

Expected next release for each country, from the pattern of its past releases.

Developer plan and upKey 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

Request

# When each office is next expected to publish
curl "https://api.tourismapi.com/v1/calendar?country=CL,BA,AT" \
  -H "X-API-Key: $TOURISM_API_KEY"

const res = await fetch("https://api.tourismapi.com/v1/calendar?country=CL,BA,AT", {
  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/calendar?country=CL,BA,AT",
    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/calendar?country=CL,BA,AT");
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_900c62c454",
        "data_as_of": "2026-10-20T04:48:24Z",
        "count": 3,
        "note": "Expected months are worked out from each office's usual delay; offices set their own dates."
    },
    "data": [
        {
            "country": "AT",
            "name": "Austria",
            "latest": "2026-08",
            "next_period": "2026-09",
            "expected_in": "2026-11",
            "usual_delay_months": 2,
            "overdue": false
        },
        {
            "country": "BA",
            "name": "Bosnia and Herzegovina",
            "latest": "2026-08",
            "next_period": "2026-09",
            "expected_in": "2026-11",
            "usual_delay_months": 2,
            "overdue": false
        },
        {
            "country": "CL",
            "name": "Chile",
            "latest": "2026-08",
            "next_period": "2026-09",
            "expected_in": "2026-11",
            "usual_delay_months": 2,
            "overdue": false
        }
    ]
}

Response fields

Field	Type	Example
country	string	AT
name	string	Austria
latest	string	2026-08
next_period	string	2026-09
expected_in	string	2026-11
usual_delay_months	number	2
overdue	boolean	false