Documentation / Measures / 22 of 75

Occupancy

GET/v1/occupancy

Bed and room occupancy as a percentage, with the rate per room where the country publishes it.

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
freqoptional	M \| Q \| A query	Frequency: monthly, quarterly or annual e.g. M
fromoptional	period query	First period to return e.g. 2025-01
tooptional	period query	Last period to return e.g. 2026-08

Request

# Bed and room occupancy rates
curl "https://api.tourismapi.com/v1/occupancy?country=CL,BA,AT&from=2025-01&to=2026-08" \
  -H "X-API-Key: $TOURISM_API_KEY"

const res = await fetch("https://api.tourismapi.com/v1/occupancy?country=CL,BA,AT&from=2025-01&to=2026-08", {
  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/occupancy?country=CL,BA,AT&from=2025-01&to=2026-08",
    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/occupancy?country=CL,BA,AT&from=2025-01&to=2026-08");
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_df49822e84",
        "data_as_of": "2026-10-20T04:48:00Z",
        "count": 3,
        "measure": "occupancy"
    },
    "data": [
        {
            "country": "CL",
            "series": null,
            "observations": [],
            "note": "No occupancy series held for CL."
        },
        {
            "country": "BA",
            "series": null,
            "observations": [],
            "note": "No occupancy series held for BA."
        },
        {
            "country": "AT",
            "series": "sr_jsdezbr0",
            "name": "Net occupancy of bed places and rooms: Bedrooms",
            "unit": "Percentage",
            "freq": "M",
            "observations": [
                {
                    "period": "2026-05",
                    "value": 41
                },
                {
                    "period": "2026-06",
                    "value": 53.5
                },
                {
                    "period": "2026-07",
                    "value": 67.1
                }
            ]
        }
    ]
}

Response fields

Field	Type	Example
country	string	CL
series	null	null
observations	array	0 items
note	string	No occupancy series held for CL.