Country coverage
GET
/v1/countries/{iso}/coverageA month-by-month grid of which measures have a value, so you can see gaps before you query.
Developer plan and upKey requiredJSON or CSVCached until the next release
Parameters
| Name | Type | Description |
|---|---|---|
| isorequired | string path | ISO 3166 two-letter country code e.g. CL |
| fromoptional | period query | First period to return e.g. 2025-01 |
| tooptional | period query | Last period to return e.g. 2026-08 |
Request
# What each measure covers for a country, month by month
curl "https://api.tourismapi.com/v1/countries/CL/coverage" \
-H "X-API-Key: $TOURISM_API_KEY"const res = await fetch("https://api.tourismapi.com/v1/countries/CL/coverage", {
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/countries/CL/coverage",
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/countries/CL/coverage");
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_9e29ea8228",
"data_as_of": "2026-10-20T04:47:58Z",
"count": 17,
"country": "CL",
"name": "Chile"
},
"data": [
{
"measure": "arrivals",
"freq": "A",
"breakdown": "total",
"series": 2,
"first": "2008",
"last": "2024",
"headline": "sr_gnvbx5rt"
},
{
"measure": "arrivals",
"freq": "M",
"breakdown": "accommodation",
"series": 1,
"first": "2026-06",
"last": "2026-08",
"headline": null
},
{
"measure": "capacity",
"freq": "M",
"breakdown": "total",
"series": 6,
"first": "2026-06",
"last": "2026-08",
"headline": null
}
]
}Response fields
| Field | Type | Example |
|---|---|---|
| measure | string | arrivals |
| freq | string | A |
| breakdown | string | total |
| series | number | 2 |
| first | string | 2008 |
| last | string | 2024 |
| headline | string | sr_gnvbx5rt |