Schemas | Tourism API documentation

Every answer is one envelope, {"meta": {...}, "data": ...} (see The response envelope). Below are the fields of data for every endpoint, read from a real answer of that endpoint, with each field's JSON type and an example. A list is shown by its first item. The same shapes are in /openapi.json, with each endpoint's example.

Countries

GET /v1/countries

data is a list of records.

Field	Type	Example
`iso`	string	HK
`name`	string	Hong Kong
`region`	string	Asia Pacific
`monthly`	boolean	true
`first`	string	2021
`latest`	string	2026-11-06
`months_behind`	integer	1
`measures`	array	[1 items]
`iso3`	string	HKG
`wikidata_id`	string	Q8646

GET /v1/countries/{iso}

data is one record.

Field	Type	Example
`iso`	string	CL
`name`	string	Chile
`region`	string	Americas
`monthly`	boolean	true
`first`	string	2020
`latest`	string	2026-08
`months_behind`	integer	3
`measures`	array	[2 items]
`statistics`	array	[3 items]
`iso3`	string	CHL
`wikidata_id`	string	Q298

GET /v1/countries/{iso}/coverage

data is a list of records.

Field	Type	Example
`measure`	string	arrivals
`freq`	string	A
`breakdown`	string	total
`series`	integer	3
`first`	string	2008
`last`	string	2024
`headline`	string	sr_gnvbx5rt

GET /v1/countries/{iso}/latest

data is one record.

Field	Type	Example
`iso`	string	CL
`period`	string	2026-08
`figures`	array	[1 items]
`figures[].measure`	string	nights
`figures[].series`	string	Tourist nights in Chile: all establis...
`figures[].value`	integer	1696082
`figures[].unit`	string	nights
`figures[].yoy_pct`	number	5.2

GET /v1/countries/{iso}/method

data is one record.

Field	Type	Example
`country`	string	CL
`name`	string	Chile
`method`	string	accommodation
`method_label`	string	Accommodation registers
`method_words`	string	Guests and nights reported by registe...
`written`	boolean	false
`basis`	string	country
`counts`	string	nights
`frequency`	string	monthly
`frequency_before`	null or value	null
`latest`	string	2026-08
`delay_months`	object	{...}
`delay_months.now`	integer	3
`delay_months.world_median`	integer	4
`revised_periods`	integer	0
`flags`	array	[0 items]
`summary`	string	Accommodation registers, monthly, abo...
`notes`	array	[3 items]
`events`	array	[2 items]
`events[].date`	string	2020
`events[].what`	string	First figures held
`compared_with_eu`	null or value	null

GET /v1/methods

data is a list of records.

Field	Type	Example
`country`	string	AL
`name`	string	Albania
`method`	string	published
`method_label`	string	Published counts
`written`	boolean	false
`basis`	string	series_name
`counts`	string	arrivals
`frequency`	string	monthly
`frequency_before`	null or value	null
`latest`	string	2026-09
`delay_months`	object	{...}
`delay_months.now`	integer	2
`delay_months.world_median`	integer	4
`revised_periods`	integer	0
`flags`	array	[0 items]
`summary`	string	Published counts, monthly, published ...

GET /v1/coverage

data is one record.

Field	Type	Example
`totals`	object	{...}
`totals.cells`	integer	93616015
`totals.values`	integer	93476341
`totals.values_served`	integer	93161424
`totals.values_withheld`	integer	314917
`totals.values_country`	integer	69953145
`totals.values_regional`	integer	4017896
`totals.values_transport`	integer	19108681
`totals.values_context`	integer	81702
`totals.series_stored`	integer	3121502
`totals.series_served`	integer	3105653
`totals.series_indexed`	integer	2494497
`totals.series_indexed_from_stored`	integer	2381057
`totals.series_derived`	integer	113440
`totals.headlines`	integer	624
`totals.collectors`	integer	102
`totals.countries`	integer	161
`totals.countries_monthly`	integer	124
`definitions`	object	{...}
`definitions.cells`	string	every observation stored, with or wit...
`definitions.values`	string	stored observations that hold a number
`definitions.values_served`	string	values from sources that are served (...
`definitions.values_country`	string	served values for a single country, i...
`definitions.values_context`	string	served values that are context beside...
`definitions.series_stored`	string	series holding at least one value: na...
`definitions.series_served`	string	stored series from served sources
`definitions.series_indexed`	string	series in the API index: served store...
`definitions.collectors`	string	publisher feeds that hold values
`checks`	array	[3 items]
`checks[].check`	string	coverage count = country coverage values
`checks[].ok`	boolean	true
`checks[].left`	integer	69946595
`checks[].right`	integer	69953145
`checks[].means`	string	the coverage count sums the same coun...
`reconciled`	boolean	true

GET /v1/regions

data is a list of records.

Field	Type	Example
`region`	string	americas
`name`	string	Americas
`countries`	array	[3 items]

GET /v1/regions/{region}

data is a list of records.

Field	Type	Example
`period`	string	2025-01
`value`	number	61584323
`countries_reporting`	integer	37

GET /v1/countries/{iso}/peers

data is a list of records.

Field	Type	Example
`iso`	string	CA
`name`	string	Canada
`region`	string	Americas
`monthly`	boolean	true
`first`	string	1972
`latest`	string	2026-09-30
`months_behind`	integer	2
`measures`	array	[3 items]
`iso3`	string	CAN
`wikidata_id`	string	Q16

GET /v1/countries/{iso}/brief

data is a list of records.

Field	Type	Example
`country`	string	TH
`name`	string	Thailand
`month`	string	2026-08
`headline`	string	A stronger August, still short of 201...
`brief`	array	[1 items]
`figures`	object	{...}
`figures.value`	integer	2714880
`figures.yoy_pct`	number	6.4
`figures.vs_2019_pct`	number	93.1
`figures.ytd_yoy_pct`	number	4.9
`figures.region_rank`	object	{...}
`figures.region_rank.rank`	integer	5
`figures.region_rank.of`	integer	12
`figures.trust`	object	{...}
`figures.trust.grade`	string	A
`figures.trust.score`	integer	96
`last_six`	array	[1 items]
`last_six[].month`	string	2026-08
`last_six[].value`	integer	2714880
`last_six[].yoy_pct`	number	6.4
`last_six[].vs_2019_pct`	number	93.1
`last_six[].vs_3yr_avg_pct`	number	12.8
`outlook`	array	[1 items]
`outlook[].month`	string	2026-09
`outlook[].value`	integer	2410000
`outlook[].low`	integer	2310000
`outlook[].high`	integer	2520000
`outlook[].yoy_pct`	number	5.2
`context`	object	{...}
`context.jet_fuel`	object	{...}
`context.jet_fuel.month`	string	2026-08
`context.jet_fuel.usd_gallon`	number	3.724
`context.jet_fuel.yoy_pct`	number	17.8
`context.currency`	object	{...}
`context.currency.currency`	string	THB
`context.currency.per_eur`	number	37.12
`context.currency.yoy_pct`	number	-2.1
`context.growth`	object	{...}
`context.growth.year`	integer	2026
`context.growth.pct`	number	2.8

GET /v1/countries/{iso}/rivals

data is a list of records.

Field	Type	Example
`country`	string	VN
`name`	string	Vietnam
`rank`	integer	1
`score`	integer	86
`shared_markets`	array	[2 items]
`shared_markets[].country`	string	CN
`shared_markets[].name`	string	China
`basis`	string	shared source markets, season, size a...

GET /v1/advisories/scale

data is a list of records.

Field	Type	Example
`kind`	string	level
`code`	string	0
`label`	string	normal precautions
`meaning`	string	The government gives its usual advice...

GET /v1/advisories

data is a list of records.

Field	Type	Example
`issuer`	string	HU
`destination`	string	KE
`destination_name`	string	Kenya
`level`	integer	2
`level_label`	string	avoid non-essential travel
`issuer_wording`	string	hu_level_2+hu_parts_3+hu_class
`applies_to_parts`	boolean	true
`parts_level`	integer	3
`level_since`	string	2026-11-02
`previous_level`	integer	0
`last_updated`	string	2023-06-15T00:00:00Z
`summary`	string	Avoid non-essential travel to Kenya b...
`places_named`	array	[3 items]
`summary_written`	string	2026-11-03T05:22:06Z

GET /v1/advisories/changes

data is a list of records.

Field	Type	Example
`issuer`	string	GB
`destination`	string	KE
`destination_name`	string	Kenya
`at`	string	2026-10-16T09:12:00Z
`note`	string	New information about Ebola screening...
`sections`	array	[1 items]
`categories`	array	[2 items]
`summary`	string	Arrivals in Kenya now face Ebola scre...
`impact`	string	medium
`impact_reason`	string	a new health check at entry

GET /v1/advisories/{iso}

data is a list of records.

Field	Type	Example
`issuer`	string	NL
`destination`	string	AE
`destination_name`	string	United Arab Emirates
`level`	integer	1
`level_label`	string	caution, or advice against travel to ...
`issuer_wording`	string	kleurcode_geel+rood_voor_delen
`applies_to_parts`	boolean	true
`parts_level`	integer	3
`level_since`	string	2026-10-29
`previous_level`	null or value	null
`last_updated`	string	2026-10-19T09:55:58Z
`summary`	string	Exercise caution when travelling to m...
`places_named`	array	[3 items]
`summary_written`	string	2026-11-03T08:42:01Z

Visitors and stays

GET /v1/arrivals

data is a list of records.

Field	Type	Example
`country`	string	CL
`series`	string	sr_gnvbx5rt
`name`	string	CHL, _Z, ARRIVALS, PS, _T, _Z, TDS, A
`unit`	string	PS
`freq`	string	A
`observations`	array	[0 items]

GET /v1/nights

data is a list of records.

Field	Type	Example
`country`	string	CL
`series`	string	sr_za1n785e
`name`	string	Tourist nights in Chile: all establis...
`unit`	string	nights
`freq`	string	M
`observations`	array	[3 items]
`observations[].period`	string	2026-06
`observations[].value`	number	1429414

GET /v1/spend

data is a list of records.

Field	Type	Example
`country`	string	CL
`series`	string	sr_a33w090d
`name`	string	CHL, EXP, USD, _T, A
`unit`	string	USD
`freq`	string	A
`observations`	array	[0 items]

GET /v1/departures

data is a list of records.

Field	Type	Example
`country`	string	CL
`series`	string	sr_r3pa07sb
`name`	string	CHL, _Z, DEPARTURES, PS, _T, _Z, _Z, A
`unit`	string	PS
`freq`	string	A
`observations`	array	[0 items]

GET /v1/occupancy

data is a list of records.

Field	Type	Example
`country`	string	CL
`series`	null or value	null
`observations`	array	[0 items]
`note`	string	No occupancy series held for CL.

GET /v1/capacity

data is a list of records.

Field	Type	Example
`country`	string	CL
`series`	null or value	null
`observations`	array	[0 items]
`note`	string	No capacity series held for CL.

GET /v1/destinations

data is a list of records.

Field	Type	Example
`place`	string	Madrid (greater city)
`code`	string	ES001C
`level`	string	city
`basis`	string	all tourist accommodation
`series`	string	sr_pyat785j
`freq`	string	A
`period`	string	2025
`nights`	number	33969574
`country_nights`	number	512892979
`share_pct`	number	6.62
`first`	string	2020
`last`	string	2025

GET /v1/venues

data is a list of records.

Field	Type	Example
`wikidata_id`	string	Q45178
`name`	string	Sydney Opera House
`country`	string	AU
`kind`	string	opera house
`lat`	number	-33.85706
`lon`	number	151.2149
`year`	integer	2026
`year_complete`	boolean	false
`visitors`	integer	10900000
`previous_year`	null or value	null
`previous_visitors`	null or value	null
`change_pct`	null or value	null
`years_held`	integer	1
`history`	array	[1 items]
`history[].year`	integer	2026
`history[].visitors`	integer	10900000

GET /v1/places

data is a list of records.

Field	Type	Example
`kind`	string	airport
`code`	string	LOWG
`name`	string	Graz Airport
`country`	string	AT
`level`	null or value	null
`parent_kind`	string	region
`parent_code`	string	AT-6
`wikidata_id`	string	Q178162
`lat`	number	46.99306
`lon`	number	15.43917

GET /v1/weather

data is a list of records.

Field	Type	Example
`place`	string	Capital Region of Denmark
`code`	string	DK01
`country`	string	DK
`level`	string	region
`period`	string	2026-10-04
`t_mean_c`	number	13.3
`t_max_c`	number	14.9
`t_min_c`	number	12.4
`rain_mm`	number	0.1
`wind_ms`	number	3.6
`sun_kwh_m2`	number	2.82
`days`	integer	1

GET /v1/hotels

data is a list of records.

Field	Type	Example
`place`	string	Benidorm
`level`	string	point
`metric`	string	adr
`what`	string	Average Daily Rate (ADR). All categor...
`period`	string	2026-01
`value`	number	78.08
`unit`	string	EUR

GET /v1/seats

data is a list of records.

Field	Type	Example
`partner_country`	string	IT
`period`	string	2024-12
`seats`	number	151157

Source markets

GET /v1/arrivals/by-origin

data is a list of records.

Field	Type	Example
`series`	string	sr_4zqx3d8x
`name`	string	Canada, Non-resident visitors enterin...
`unit`	string	Visitors
`value`	number	4222163

GET /v1/nights/by-accommodation

data is a list of records.

Field	Type	Example
`series`	string	sr_85g2v1ta
`name`	string	Tourist nights in Chile: hotels
`unit`	string	nights
`value`	number	1333264

GET /v1/nights/by-region

data is a list of records.

Field	Type	Example
`series`	string	sr_d1jex8kh
`name`	string	SLOVENIA
`unit`	string
`value`	number	17843311

GET /v1/arrivals/by-purpose

data is a list of records.

Field	Type	Example
`series`	string	sr_qv12q8ks
`name`	string	The Netherlands, All leisure accommod...
`unit`	string	number
`value`	number	40540800

GET /v1/origins/{iso}

data is a list of records.

Field	Type	Example
`destination`	string	BR
`name`	string	Brazil
`series`	string	sr_zp5gxc9w
`unit`	string	arrivals
`freq`	string	M
`period`	string	2026-08
`value`	integer	31506

Series

GET /v1/series

data is a list of records.

Field	Type	Example
`id`	string	sr_gnvbx5rt
`alias`	string	cl.arrivals.total.a
`country`	string	CL
`name`	string	CHL, _Z, ARRIVALS, PS, _T, _Z, TDS, A
`measure`	string	arrivals
`breakdown`	null or value	null
`freq`	string	A
`unit`	string	PS
`first`	string	2008
`last`	string	2024
`points`	integer	17
`headline`	boolean	true

GET /v1/series/{id}

data is one record.

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 or value	null
`freq`	string	M
`unit`	string	visitors
`first`	string	2003-01
`last`	string	2026-09
`points`	integer	285
`headline`	boolean	true

GET /v1/series/{id}/observations

data is a list of records.

Field	Type	Example
`period`	string	2025-01
`value`	number	3781629

GET /v1/series/{id}/revisions

data is a list of records.

Field	Type	Example
`period`	string	2026-07
`was`	number	3442100
`now`	number	3442310
`revised_at`	string	2026-10-28T15:23:09Z

GET /v1/series/{id}/metadata

data is one record.

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 or value	null
`freq`	string	M
`unit`	string	visitors
`first`	string	2003-01
`last`	string	2026-09
`points`	integer	285
`headline`	boolean	true
`table`	string	Visitor arrivals to Japan by nationality
`derived`	boolean	false
`latest_value`	number	3103700
`currency`	null or value	null
`scale`	null or value	null
`revisions`	integer	1
`last_revised`	string	2026-10-28T15:23:09Z
`updated`	string	2026-11-04T15:23:05Z
`definition`	object	{...}
`definition.what`	string	Visitor arrivals to Japan from Total
`definition.table`	string	Visitor arrivals to Japan by nationality
`definition.unit`	string	visitors
`definition.frequency`	string	M
`method`	object	{...}
`method.kind`	string	border
`method.label`	string	Border records
`method.how`	string	Arrivals recorded at the border: the ...
`source_kind`	object	{...}
`source_kind.kind`	string	tourism
`source_kind.label`	string	national tourism ministry, authority ...
`revision_status`	object	{...}
`revision_status.status`	string	revised
`revision_status.revisions`	integer	1
`revision_status.last_revised`	string	2026-10-28T15:23:09Z
`revision_status.tracked_since`	string	2026-10-07

GET /v1/series/search

data is a list of records.

Field	Type	Example
`id`	string	sr_2efm01hs
`alias`	null or value	null
`country`	string	NO
`name`	string	Hotels and similar establishments, Fo...
`measure`	string	capacity
`breakdown`	null or value	null
`freq`	string	M
`unit`	string
`first`	string	2010-01
`last`	string	2019-12
`points`	integer	120
`headline`	boolean	false

GET /v1/tables

data is a list of records.

Field	Type	Example
`table`	string	Enterprises and employment in tourism
`series`	integer	18
`first`	string	2008
`last`	string	2024
`measures`	array	[0 items]

GET /v1/series/{id}/latest

data is one record.

Field	Type	Example
`series`	string	sr_wxq9yq5v
`name`	string	Visitor arrivals to Japan from Total
`unit`	string	visitors
`period`	string	2026-09
`value`	number	3103700
`year_before`	number	3267228
`yoy_pct`	number	-5

Compare and rank

GET /v1/compare

data is a list of records.

Field	Type	Example
`period`	string	2025-01
`CL`	null or value	null
`BA`	null or value	null
`AT`	number	3491284

GET /v1/rank

data is a list of records.

Field	Type	Example
`rank`	integer	1
`country`	string	FR
`name`	string	France
`series`	string	sr_fea62wdk
`unit`	string	Number
`period`	string	2026-08
`value`	number	26741423
`year_before`	number	27088143
`yoy_pct`	number	-1.3

GET /v1/growth

data is a list of records.

Field	Type	Example
`country`	string	CL
`note`	string	No arrivals figure held for CL at tha...

GET /v1/share

data is one record.

Field	Type	Example
`country`	string	TH
`origin`	string	CN
`period`	string	2026-09
`series`	string	sr_w0c0m2wv
`unit`	string	tourists
`value`	number	349182
`total`	number	7753616
`share_pct`	number	4.5
`year_before`	number	321309

GET /v1/seasonality

data is a list of records.

Field	Type	Example
`month`	integer	1
`index`	number	106.3
`low`	number	106.3
`high`	number	106.3

GET /v1/movers

data is one record.

Field	Type	Example
`rising`	array	[3 items]
`rising[].country`	string	UG
`rising[].name`	string	Uganda
`rising[].series`	string	sr_437q2pmf
`rising[].unit`	string	visitors
`rising[].period`	string	2025-12
`rising[].value`	number	162493
`rising[].year_before`	number	123566
`rising[].yoy_pct`	number	31.5
`falling`	array	[3 items]
`falling[].country`	string	LT
`falling[].name`	string	Lithuania
`falling[].series`	string	sr_hn6vne81
`falling[].unit`	string	Number
`falling[].period`	string	2026-08
`falling[].value`	number	521700
`falling[].year_before`	number	579572
`falling[].yoy_pct`	number	-10

GET /v1/records

data is a list of records.

Field	Type	Example
`country`	string	AT
`name`	string	Austria
`series`	string	sr_tn5yvzzv
`unit`	string	Number
`record_period`	string	2026-08
`record_value`	number	5667172
`latest_period`	string	2026-08
`latest_value`	number	5667172
`pct_of_record`	number	100
`latest_is_record`	boolean	true

GET /v1/seasons

data is a list of records.

Field	Type	Example
`iso`	string	AL
`name`	string	Albania
`measure`	string	arrivals
`index`	array	[3 items]
`busiest`	string	August
`quietest`	string	February
`swing`	number	4.33
`years`	integer	3
`through`	string	2026-07

GET /v1/seasons/{iso}

data is one record.

Field	Type	Example
`iso`	string	CL
`name`	string	Chile
`measure`	string	nights
`busiest`	string	February
`quietest`	string	June
`swing`	number	1.58
`years`	integer	3
`through`	string	2026-08
`months`	array	[3 items]
`months[].month`	string	October
`months[].index`	number	93.7

GET /v1/annual/{year}

data is a list of records.

Field	Type	Example
`iso`	string	US
`name`	string	United States
`measure`	string	arrivals
`unit`	string	passengers
`total`	integer	258650354
`change_pct`	number	1.1
`basis`	string	twelve months

GET /v1/direction

data is a list of records.

Field	Type	Example
`iso`	string	AL
`name`	string	Albania
`region`	string	Europe
`month`	string	2026-07
`direction`	string	up

Statistics and forecasts

GET /v1/stats/trend

data is a list of records.

Field	Type	Example
`period`	string	2018-10
`adjusted`	number	2461066.5

GET /v1/stats/recovery

data is a list of records.

Field	Type	Example
`period`	string	2020-01
`index`	number	98.95

GET /v1/stats/benchmark

data is a list of records.

Field	Type	Example
`year`	string	2015
`country`	number	61.9
`region`	number	84.8

GET /v1/stats/stay-length

data is a list of records.

Field	Type	Example
`period`	string	2020-07
`nights_per_arrival`	number	2.516

GET /v1/stats/forecast

data is a list of records.

Field	Type	Example
`period`	string	2026-10
`value`	number	3436583
`low`	number	3161983
`high`	number	3735031

GET /v1/stats/nowcast

data is a list of records.

Field	Type	Example
`period`	string	2026-10
`value`	number	3708645
`low`	number	3412306
`high`	number	4030720
`estimated`	boolean	true

GET /v1/stats/anomalies

data is a list of records.

Field	Type	Example
`period`	string	2020-03
`score`	number	-6.6
`expected`	number	975350

GET /v1/stats/origin-shift

data is a list of records.

Field	Type	Example
`origin`	string	China
`share_pct`	number	12.24
`change_points`	number	-10.49

GET /v1/stats/concentration

data is one record.

Field	Type	Example
`hhi`	integer	1408
`top3_share_pct`	number	58.4
`window`	string	2025-10 to 2026-09
`markets`	integer	39
`top`	object	{...}
`top.South Korea`	number	27.1
`top.Taiwan`	number	19.1
`top.China`	number	12.2
`top.United States`	number	8.5
`top.Hong Kong`	number	6.6

GET /v1/stats/fx-sensitivity

data is a list of records.

Field	Type	Example
`origin`	string	US
`name`	string	United States
`currency`	string	USD
`series`	string	sr_p4b6agqg
`months`	integer	227
`elasticity`	number	-0.47
`correlation`	number	-0.28
`reading`	string	A 10% dearer JPY for United States tr...

GET /v1/stats/tourism-intensity

data is a list of records.

Field	Type	Example
`rank`	integer	1
`country`	string	AD
`name`	string	Andorra
`year`	integer	2019
`arrivals_per_resident`	number	107.684
`receipts_per_resident_usd`	number	24976
`arrivals`	integer	8235000
`population`	integer	76474

Holidays

GET /v1/holidays

data is a list of records.

Field	Type	Example
`country`	string	AT
`date`	string	2025-01-01
`name`	string	New Year's Day
`local_name`	string	Neujahr
`national`	boolean	true

GET /v1/holidays/{iso}

data is a list of records.

Field	Type	Example
`country`	string	CL
`date`	string	2026-01-01
`name`	string	New Year's Day
`local_name`	string	Año Nuevo
`national`	boolean	true

GET /v1/joins/holidays

data is a list of records.

Field	Type	Example
`period`	string	2025-01
`value`	number	3781629
`holidays`	integer	2
`holiday_list`	array	[2 items]
`holiday_list[].date`	string	2025-01-01
`holiday_list[].name`	string	New Year's Day

GET /v1/holidays/upcoming

data is a list of records.

Field	Type	Example
`country`	string	TH
`date`	string	2026-12-05
`name`	string	HM King Bhumibol Adulyadej the Great'...
`local_name`	string	วันคล้ายวันเฉลิมพระชนมพรรษาพระบาทสมเด...
`national`	boolean	true
`in_days`	integer	28

GET /v1/holidays/on

data is a list of records.

Field	Type	Example
`country`	string	BY
`country_name`	string	Belarus
`name`	string	October Revolution Day
`local_name`	string	Дзень Кастрычніцкай рэвалюцыі
`national`	boolean	true

GET /v1/holidays/school

data is a list of records.

Field	Type	Example
`country`	string	NL
`region`	string	zuid
`zone`	null or value	null
`name`	string	Voorjaarsvakantie
`name_en`	string	Spring holidays
`school_year`	string	2026-2027
`first_day`	string	2027-02-13
`last_day`	string	2027-02-21
`days`	integer	9

GET /v1/holidays/long-weekends/{iso}

data is a list of records.

Field	Type	Example
`start`	string	2026-01-01
`end`	string	2026-01-04
`days`	integer	4
`holidays`	array	[1 items]
`take_off`	array	[1 items]

GET /v1/holidays/matrix

data is a list of records.

Field	Type	Example
`iso`	string	AF
`name`	string	Afghanistan
`months`	array	[3 items]
`total`	integer	14

Money and fuel

GET /v1/fares

data is a list of records.

Field	Type	Example
`airport`	string	LAX
`period`	string	2024-Q1
`average_fare_usd`	number	271.04
`passengers_per_day`	number	76457

GET /v1/prices

data is a list of records.

Field	Type	Example
`country`	string	ES
`item`	string	hotels
`period`	string	2026-01
`index`	null or value	null
`change_pct`	null or value	null
`nights`	null or value	null

GET /v1/fx

data is a list of records.

Field	Type	Example
`quote`	string	AUD
`base`	string	EUR
`date`	string	2026-11-02
`rate`	number	1.6004

GET /v1/fx/{currency}

data is a list of records.

Field	Type	Example
`quote`	string	THB
`base`	string	EUR
`date`	string	2025-11-07
`rate`	number	37.388

GET /v1/convert

data is a list of records.

Field	Type	Example
`period`	string	2026-08
`value`	integer	89828
`converted`	number	94.3
`rate`	number	952.6

GET /v1/fx/latest

data is a list of records.

Field	Type	Example
`quote`	string	USD
`rate`	number	1.1165

GET /v1/fuel

data is a list of records.

Field	Type	Example
`month`	string	2025-01
`jet_fuel_usd_gallon`	number	2.347
`jet_fuel_usd_litre`	number	0.62
`jet_fuel_index`	number	125
`jet_fuel_yoy_pct`	number	-9.2
`crude_usd_barrel`	number	79.27
`crude_index`	number	123.2
`crude_yoy_pct`	number	-1.1

GET /v1/fuel/latest

data is a list of records.

Field	Type	Example
`month`	string	2026-10
`jet_fuel_usd_gallon`	number	4.483
`jet_fuel_usd_litre`	number	1.184
`jet_fuel_index`	number	238.8
`jet_fuel_yoy_pct`	number	108.1
`crude_usd_barrel`	number	123.93
`crude_index`	number	192.6
`crude_yoy_pct`	number	92

GET /v1/fx/matrix

data is one record.

Field	Type	Example
`date`	string	2026-11-06
`currencies`	array	[3 items]
`rates`	object	{...}
`rates.USD`	object	{...}
`rates.USD.USD`	number	1
`rates.USD.EUR`	number	0.895656
`rates.USD.GBP`	number	0.747112
`rates.USD.JPY`	number	158.325
`rates.USD.CNY`	number	6.67129
`rates.USD.THB`	number	33.5504
`rates.EUR`	object	{...}
`rates.EUR.USD`	number	1.1165
`rates.EUR.EUR`	number	1
`rates.EUR.GBP`	number	0.83415
`rates.EUR.JPY`	number	176.77
`rates.EUR.CNY`	number	7.4485
`rates.EUR.THB`	number	37.459
`rates.GBP`	object	{...}
`rates.GBP.USD`	number	1.33849
`rates.GBP.EUR`	number	1.19883
`rates.GBP.GBP`	number	1
`rates.GBP.JPY`	number	211.916
`rates.GBP.CNY`	number	8.92945
`rates.GBP.THB`	number	44.9068
`rates.JPY`	object	{...}
`rates.JPY.USD`	number	0.00631612
`rates.JPY.EUR`	number	0.00565707
`rates.JPY.GBP`	number	0.00471884
`rates.JPY.JPY`	number	1
`rates.JPY.CNY`	number	0.0421367
`rates.JPY.THB`	number	0.211908
`rates.CNY`	object	{...}
`rates.CNY.USD`	number	0.149896
`rates.CNY.EUR`	number	0.134255
`rates.CNY.GBP`	number	0.111989
`rates.CNY.JPY`	number	23.7323
`rates.CNY.CNY`	number	1
`rates.CNY.THB`	number	5.02907
`rates.THB`	object	{...}
`rates.THB.USD`	number	0.0298059

Economy

GET /v1/economy/{iso}

data is a list of records.

Field	Type	Example
`year`	integer	2031
`projection`	boolean	true
`gdp_growth_pct`	number	2.3
`inflation_pct`	number	3
`gdp_usd_bn`	number	486.5
`gdp_per_capita_usd`	number	23676
`population_m`	number	20.55
`unemployment_pct`	number	7.8
`current_account_pct_gdp`	number	-1.5

GET /v1/economy/{iso}/tourism

data is a list of records.

Field	Type	Example
`year`	integer	2025
`receipts_usd`	null or value	null
`spending_abroad_usd`	null or value	null
`arrivals`	integer	118327077
`receipts_per_arrival_usd`	null or value	null
`receipts_share_gdp_pct`	null or value	null

GET /v1/economy/outlook

data is a list of records.

Field	Type	Example
`country`	string	CL
`name`	string	Chile
`gdp_growth_2026`	number	0.6
`inflation_2026`	number	3.7
`gdp_growth_2027`	number	2.6
`inflation_2027`	number	3.5
`gdp_growth_2028`	number	2.4
`inflation_2028`	number	3

Population and reference

GET /v1/reference/countries

data is a list of records.

Field	Type	Example
`iso`	string	AD
`iso3`	string	AND
`numeric`	string	020
`name`	string	Andorra
`region`	string	Europe & Central Asia
`currency`	string	EUR
`currency_name`	string	Euro
`income_group`	string	High income
`time_zones`	array	[1 items]
`tourism_figures`	string	none yet

GET /v1/reference/timezones/{iso}

data is a list of records.

Field	Type	Example
`zone`	string	America/Coyhaique
`utc_offset`	string	-03:00
`offset_minutes`	integer	-180
`abbreviation`	string	-03
`summer_time`	boolean	false
`local_time`	string	2026-11-07T01:51:51-03:00
`next_change`	null or value	null

GET /v1/coverage/matrix

data is a list of records.

Field	Type	Example
`iso`	string	AL
`name`	string	Albania
`region`	string	Europe
`arrivals`	object	{...}
`arrivals.first`	string	2017-06
`arrivals.latest`	string	2026-09
`arrivals.frequencies`	array	[2 items]
`arrivals.series`	integer	107
`nights`	object	{...}
`nights.first`	string	2017-06
`nights.latest`	string	2026-08
`nights.frequencies`	array	[2 items]
`nights.series`	integer	141
`spend`	object	{...}
`spend.first`	string	2015-Q1
`spend.latest`	string	2026-Q2
`spend.frequencies`	array	[2 items]
`spend.series`	integer	808
`departures`	object	{...}
`departures.first`	string	2017
`departures.latest`	string	2020
`departures.frequencies`	array	[1 items]
`departures.series`	integer	209
`occupancy`	object	{...}
`occupancy.first`	string	2017-06
`occupancy.latest`	string	2026-08
`occupancy.frequencies`	array	[1 items]
`occupancy.series`	integer	2
`capacity`	null or value	null

GET /v1/population

data is a list of records.

Field	Type	Example
`iso`	string	IN
`name`	string	India
`year`	integer	2025
`total`	integer	1463865525
`female`	integer	709090076
`male`	integer	754775449
`children_pct`	number	24.2
`working_age_pct`	number	68.43
`older_pct`	number	7.38
`urban_pct`	number	35.69
`density_per_km2`	number	488.01
`growth_pct`	number	0.89
`life_expectancy`	number	72.24
`fertility_rate`	number	1.96
`latest_census`	integer	2011

GET /v1/population/{iso}

data is one record.

Field	Type	Example
`iso`	string	CL
`name`	string	Chile
`latest_census`	integer	2017
`census_note`	null or value	null
`latest_household_survey`	string	Global School-based Student Health Su...
`births_and_deaths_fully_registered`	boolean	true
`figures`	object	{...}
`figures.total`	object	{...}
`figures.total.value`	integer	19859921
`figures.total.year`	integer	2025
`figures.total.unit`	string	people
`figures.total.label`	string	Population
`figures.female`	object	{...}
`figures.female.value`	integer	9988733
`figures.female.year`	integer	2025
`figures.female.unit`	string	people
`figures.female.label`	string	Women and girls
`figures.male`	object	{...}
`figures.male.value`	integer	9871188
`figures.male.year`	integer	2025
`figures.male.unit`	string	people
`figures.male.label`	string	Men and boys
`figures.female_pct`	object	{...}
`figures.female_pct.value`	number	50.3
`figures.female_pct.year`	integer	2025
`figures.female_pct.unit`	string	percent
`figures.female_pct.label`	string	Women and girls, share of the population
`figures.children_0_14`	object	{...}
`figures.children_0_14.value`	integer	3286221
`figures.children_0_14.year`	integer	2025
`figures.children_0_14.unit`	string	people
`figures.children_0_14.label`	string	Children aged 0 to 14
`figures.working_age_15_64`	object	{...}
`figures.working_age_15_64.value`	integer	13676187
`figures.working_age_15_64.year`	integer	2025
`figures.working_age_15_64.unit`	string	people
`figures.working_age_15_64.label`	string	People aged 15 to 64
`figures.older_65_plus`	object	{...}
`figures.older_65_plus.value`	integer	2897512
`figures.older_65_plus.year`	integer	2025

GET /v1/population/{iso}/pyramid

data is a list of records.

Field	Type	Example
`ages`	string	0-4
`female`	integer	444608
`male`	integer	462977
`total`	integer	907585
`share_pct`	number	4.57

GET /v1/population/{iso}/history

data is a list of records.

Field	Type	Example
`year`	integer	1960
`value`	integer	8153350

GET /v1/census

data is a list of records.

Field	Type	Example
`iso`	string	AF
`name`	string	Afghanistan
`latest_census`	integer	1979
`census_note`	null or value	null
`latest_household_survey`	string	Multiple Indicator Cluster Survey 202...
`births_and_deaths_fully_registered`	null or value	null

Releases and the Monitor

GET /v1/releases

data is a list of records.

Field	Type	Example
`date`	string	2026-11-04
`country`	string	AT
`series_updated`	integer	1956
`latest_period`	string	2026-08
`measures`	array	[3 items]

GET /v1/releases/latest

data is a list of records.

Field	Type	Example
`date`	string	2026-11-06
`country`	string	HU
`series_updated`	integer	434
`latest_period`	string	2026-09
`measures`	array	[3 items]

GET /v1/freshness

data is a list of records.

Field	Type	Example
`iso`	string	KI
`name`	string	Kiribati
`latest`	string	2018-12
`months_behind`	integer	95

GET /v1/gaps

data is a list of records.

Field	Type	Example
`country`	string	CL
`name`	string	Chile
`measure`	string	nights
`series`	string	sr_za1n785e
`first`	string	2020-07
`latest`	string	2026-08
`months_held`	integer	62
`months_missing`	integer	12
`months_not_published`	integer	0
`months_withheld`	integer	0
`months_pending`	integer	2
`complete_pct`	number	83.8
`missing`	array	[3 items]
`missing[].0`	string	2025-02
`missing[].1`	string	2025-04
`not_published`	array	[0 items]
`withheld`	array	[0 items]
`checked_at`	string	2026-11-06T09:37:10Z

GET /v1/calendar

data is a list of records.

Field	Type	Example
`country`	string	AT
`name`	string	Austria
`latest`	string	2026-09
`next_period`	string	2026-10
`expected_in`	string	2026-12
`usual_delay_months`	integer	2
`overdue`	boolean	false

GET /v1/changelog

data is a list of records.

Field	Type	Example
`date`	string	2026-10-28
`change`	string	US air fares: /v1/fares gives the ave...

GET /v1/monitor

data is one record.

Field	Type	Example
`month`	string	2026-08
`edition`	string	world
`title`	string	World
`built_at`	string	2026-11-06T05:41:48Z
`headline`	object	{...}
`headline.countries`	integer	77
`headline.growing`	integer	50
`headline.compared`	integer	75
`headline.yoy_pct`	number	2.3
`headline.vs_2019_pct`	number	107.2
`headline.records`	integer	21
`headline.trust`	integer	99
`regions`	array	[3 items]
`regions[].region`	string	americas
`regions[].name`	string	Americas
`regions[].countries`	integer	11
`regions[].yoy_pct`	number	5.5
`regions[].vs_2019_pct`	number	129.8
`rising`	array	[3 items]
`rising[].country`	string	KR
`rising[].name`	string	South Korea
`rising[].region`	string	asia-pacific
`rising[].measure`	string	arrivals
`rising[].unit`	string	visitors
`rising[].series`	string	sr_00pwc2k1
`rising[].basis`	string	border
`rising[].value`	integer	2245293
`rising[].year_before`	integer	1820332
`rising[].yoy_pct`	number	23.3
`rising[].vs_2019_pct`	number	141.5
`rising[].series_break`	boolean	false
`rising[].pct_of_record`	integer	100
`rising[].record`	boolean	true
`falling`	array	[3 items]
`falling[].country`	string	CR
`falling[].name`	string	Costa Rica
`falling[].region`	string	americas
`falling[].measure`	string	arrivals
`falling[].unit`	string	tourists
`falling[].series`	string	sr_2gfft2v7

GET /v1/monitor/editions

data is a list of records.

Field	Type	Example
`month`	string	2026-09
`edition`	string	africa
`countries`	integer	3
`status`	string	early
`release`	string	early
`released_at`	null or value	null
`emailed_at`	null or value	null
`paper`	boolean	false
`built_at`	string	2026-11-06T05:41:48Z

GET /v1/monitor/paper

data is one record.

Field	Type	Example
`month`	string	2026-08
`issue`	integer	140
`reference`	string	TAPI-WTM-2026-08-WLD
`title`	string	World Tourism Monitor, August 2026
`built_at`	string	2026-10-30T06:01:03Z
`edition_built_at`	string	2026-10-30T06:00:25Z
`cite`	string	Tourism API (2026). World Tourism Mon...
`brief`	string	International arrivals moved +2.4% on...
`kf`	array	[3 items]
`kf[].0`	string	Against August 2019
`kf[].1`	string	108.9%
`kf[].2`	string
`key_findings`	array	[3 items]
`sections`	array	[3 items]
`sections[].no`	integer	26
`sections[].kick`	string	Appendix B
`sections[].title`	string	Economic tables
`sections[].dek`	string	Growth, inflation, unemployment and o...
`sections[].paragraphs`	array	[0 items]
`sections[].figures`	array	[0 items]
`sections[].tables`	array	[1 items]
`facts`	array	[3 items]
`figures`	array	[3 items]
`figures[].no`	integer	19
`figures[].title`	string	The world figure for the next three m...
`figures[].unit`	string	Change on a year, %
`figures[].type`	string	band
`figures[].data`	object	{...}
`figures[].data.months`	array	[3 items]
`figures[].data.value`	array	[3 items]
`figures[].data.low`	array	[3 items]
`figures[].data.high`	array	[3 items]
`figures[].source`	string	Tourism API, /v1/stats/forecast, comb...
`figures[].call`	string	/v1/stats/forecast?country=ES&horizon=3
`tables`	array	[3 items]
`tables[].no`	integer	21
`tables[].title`	string	Economic figures by country
`tables[].head`	array	[3 items]
`tables[].rows`	array	[3 items]
`tables[].rows[].0`	string	2.1

GET /v1/monitor/index

data is a list of records.

Field	Type	Example
`month`	string	2025-01
`countries`	integer	96
`yoy_pct`	number	13.3
`vs_2019_pct`	number	109.7
`growing`	integer	74
`compared`	integer	93
`records`	integer	8
`trust`	integer	97

GET /v1/monitor/trust

data is a list of records.

Field	Type	Example
`country`	string	CL
`name`	string	Chile
`region`	string	americas
`measure`	string	nights
`series`	string	sr_za1n785e
`fresh`	integer	100
`complete`	integer	80
`stable`	integer	100
`official`	integer	100
`score`	integer	94
`grade`	string	A

Files and account

GET /v1/bulk/{iso}.csv

data is one record.

No fields: the endpoint answers a file or a status.

GET /v1/bulk/all.zip

data is one record.

Field	Type	Example
`file`	string	all.zip
`countries`	integer	199
`built_at`	string	2026-10-12T09:41:07Z
`manifest`	string	/v1/bulk/manifest.json

GET /v1/units

data is one record.

Field	Type	Example
`counts`	array	[3 items]
`counts[].unit`	string	nights
`counts[].scale`	integer	1
`rates`	array	[2 items]
`rates[].unit`	string	percent
`rates[].scale`	integer	1
`currencies`	array	[3 items]
`periods`	array	[3 items]

GET /v1/usage

data is one record.

Field	Type	Example
`today`	integer	214
`month`	integer	3880
`by_endpoint`	object	{...}
`by_endpoint./v1/arrivals`	integer	120
`by_endpoint./v1/series/{id}/observations`	integer	94

GET /v1/status

data is one record.

Field	Type	Example
`ok`	boolean	true
`last_load`	string	2026-11-07T04:14:01Z
`countries`	integer	161
`monthly_countries`	integer	124
`monthly_within_2_months`	integer	41
`endpoints_live`	integer	110
`status_page`	string	https://tourismapi.com/status