Documentation / Series / 40 of 107

Series metadata

GET/v1/series/{id}/metadata

What the series is (its definition, table, unit and frequency), how it was counted, the kind of body that publishes it, and whether its figures have been revised since first published, with the count and the last revision.

Developer plan and upKey requiredJSON or CSVCached until the next release

Parameters

Name	Type	Description
idrequired	string path	Series id from /v1/series e.g. jp.arrivals.total.m

Request

# Definitions, units and breaks in the series
curl "https://api.tourismapi.com/v1/series/jp.arrivals.total.m/metadata" \
  -H "X-API-Key: $TOURISM_API_KEY"

const res = await fetch("https://api.tourismapi.com/v1/series/jp.arrivals.total.m/metadata", {
  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/series/jp.arrivals.total.m/metadata",
    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/series/jp.arrivals.total.m/metadata");
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_89b193ab42",
        "data_as_of": "2026-11-07T04:51:44Z",
        "count": 1
    },
    "data": {
        "id": "sr_wxq9yq5v",
        "alias": "jp.arrivals.total.m",
        "country": "JP",
        "name": "Visitor arrivals to Japan from Total",
        "measure": "arrivals",
        "breakdown": null,
        "freq": "M",
        "unit": "visitors",
        "first": "2003-01",
        "last": "2026-09",
        "points": 285,
        "headline": true,
        "table": "Visitor arrivals to Japan by nationality",
        "derived": false,
        "latest_value": 3103700,
        "currency": null,
        "scale": null,
        "revisions": 1,
        "last_revised": "2026-10-28T15:23:09Z",
        "updated": "2026-11-04T15:23:05Z",
        "definition": {
            "what": "Visitor arrivals to Japan from Total",
            "table": "Visitor arrivals to Japan by nationality",
            "unit": "visitors",
            "frequency": "M"
        },
        "method": {
            "kind": "border",
            "label": "Border records",
            "how": "Arrivals recorded at the border: the immigration record or arrival card taken of every traveller entering."
        },
        "source_kind": {
            "kind": "tourism",
            "label": "national tourism ministry, authority or board"
        },
        "revision_status": {
            "status": "revised",
            "revisions": 1,
            "last_revised": "2026-10-28T15:23:09Z",
            "tracked_since": "2026-10-07"
        }
    }
}

Response fields

Field	Type	Example
id	string	sr_wxq9yq5v
alias	string	jp.arrivals.total.m
country	string	JP
name	string	Visitor arrivals to Japan from Total
measure	string	arrivals
breakdown	null	null
freq	string	M
unit	string	visitors
first	string	2003-01
last	string	2026-09
points	number	285
headline	boolean	true
table	string	Visitor arrivals to Japan by nationality
derived	boolean	false
latest_value	number	3103700
currency	null	null
scale	null	null
revisions	number	1
last_revised	string	2026-10-28T15:23:09Z
updated	string	2026-11-04T15:23:05Z
definition	object	object
method	object	object
source_kind	object	object
revision_status	object	object