214 countries and territories189 of 193 UN membersmonthly to 2026-09back to 1926
Documentation / Guides / Reading a response / 13 of 25

Schemas

The fields of every endpoint's answer, with their type and an example.

Guide

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.

FieldTypeExample
isostringBT
namestringBhutan
regionstringAsia Pacific
monthlybooleantrue
firststring2025
lateststring2026-09
months_behindinteger1
measuresarray[2 items]
iso3stringBTN
wikidata_idstringQ917

GET /v1/countries/{iso}

data is one record.

FieldTypeExample
isostringCL
namestringChile
regionstringAmericas
monthlybooleantrue
firststring2026
lateststring2026-08
months_behindinteger2
measuresarray[3 items]
statisticsarray[0 items]
iso3stringCHL
wikidata_idstringQ298

GET /v1/countries/{iso}/coverage

data is a list of records.

FieldTypeExample
measurestringarrivals
freqstringA
breakdownstringtotal
seriesinteger2
firststring2008
laststring2024
headlinestringsr_gnvbx5rt

GET /v1/countries/{iso}/latest

data is one record.

FieldTypeExample
isostringCL
periodstring2026-08
figuresarray[3 items]
figures[].measurestringarrivals
figures[].valueinteger798946
figures[].unitstringarrivals
figures[].yoy_pctnumber-1.8

GET /v1/regions

data is a list of records.

FieldTypeExample
regionstringamericas
namestringAmericas
countriesarray[3 items]

GET /v1/regions/{region}

data is a list of records.

FieldTypeExample
periodstring2025-01
valuenumber51963828
countries_reportinginteger37

GET /v1/countries/{iso}/peers

data is a list of records.

FieldTypeExample
isostringCA
namestringCanada
regionstringAmericas
monthlybooleantrue
firststring1972
lateststring2026-09-30
months_behindinteger1
measuresarray[3 items]
iso3stringCAN
wikidata_idstringQ16

GET /v1/countries/{iso}/brief

data is a list of records.

FieldTypeExample
countrystringTH
namestringThailand
monthstring2026-08
headlinestringA stronger August, still short of 201...
briefarray[1 items]
figuresobject{...}
figures.valueinteger2714880
figures.yoy_pctnumber6.4
figures.vs_2019_pctnumber93.1
figures.ytd_yoy_pctnumber4.9
figures.region_rankobject{...}
figures.region_rank.rankinteger5
figures.region_rank.ofinteger12
figures.trustobject{...}
figures.trust.gradestringA
figures.trust.scoreinteger96
last_sixarray[1 items]
last_six[].monthstring2026-08
last_six[].valueinteger2714880
last_six[].yoy_pctnumber6.4
last_six[].vs_2019_pctnumber93.1
last_six[].vs_3yr_avg_pctnumber12.8
outlookarray[1 items]
outlook[].monthstring2026-09
outlook[].valueinteger2410000
outlook[].lowinteger2310000
outlook[].highinteger2520000
outlook[].yoy_pctnumber5.2
contextobject{...}
context.jet_fuelobject{...}
context.jet_fuel.monthstring2026-08
context.jet_fuel.usd_gallonnumber3.724
context.jet_fuel.yoy_pctnumber17.8
context.currencyobject{...}
context.currency.currencystringTHB
context.currency.per_eurnumber37.12
context.currency.yoy_pctnumber-2.1
context.growthobject{...}
context.growth.yearinteger2026
context.growth.pctnumber2.8

GET /v1/countries/{iso}/rivals

data is a list of records.

FieldTypeExample
countrystringVN
namestringVietnam
rankinteger1
scoreinteger86
shared_marketsarray[2 items]
shared_markets[].countrystringCN
shared_markets[].namestringChina
basisstringshared source markets, season, size a...

Series

GET /v1/series

data is a list of records.

FieldTypeExample
idstringsr_gnvbx5rt
aliasstringcl.arrivals.total.a
countrystringCL
namestringCHL, _Z, ARRIVALS, PS, _T, _Z, TDS, A
measurestringarrivals
breakdownnull or valuenull
freqstringA
unitstringPS
firststring2008
laststring2024
pointsinteger17
headlinebooleantrue

GET /v1/series/{id}

data is one record.

FieldTypeExample
idstringsr_wxq9yq5v
aliasstringjp.arrivals.total.m
countrystringJP
namestringVisitor arrivals to Japan from Total
measurestringarrivals
breakdownnull or valuenull
freqstringM
unitstringvisitors
firststring2003-01
laststring2026-08
pointsinteger284
headlinebooleantrue

GET /v1/series/{id}/observations

data is a list of records.

FieldTypeExample
periodstring2025-01
valuenumber3781629

GET /v1/series/{id}/revisions

data is a list of records.

FieldTypeExample
periodstring2026-06
oldinteger48211904
newinteger48390117
seen_atstring2026-10-12T10:51:15Z

GET /v1/series/{id}/metadata

data is one record.

FieldTypeExample
idstringsr_wxq9yq5v
aliasstringjp.arrivals.total.m
countrystringJP
namestringVisitor arrivals to Japan from Total
measurestringarrivals
breakdownnull or valuenull
freqstringM
unitstringvisitors
firststring2003-01
laststring2026-08
pointsinteger284
headlinebooleantrue
tablestringVisitor arrivals to Japan by nationality
derivedbooleanfalse
latest_valuenumber3098900
currencynull or valuenull
scalenull or valuenull
revisionsinteger0
last_revisednull or valuenull
updatedstring2026-10-13T02:37:15Z

GET /v1/series/search

data is a list of records.

FieldTypeExample
idstringsr_2efm01hs
aliasnull or valuenull
countrystringNO
namestringHotels and similar establishments, Fo...
measurestringcapacity
breakdownnull or valuenull
freqstringM
unitstring
firststring2010-01
laststring2019-12
pointsinteger120
headlinebooleanfalse

GET /v1/tables

data is a list of records.

FieldTypeExample
tablestringEnterprises and employment in tourism
seriesinteger18
firststring2008
laststring2024
measuresarray[0 items]

GET /v1/series/{id}/latest

data is one record.

FieldTypeExample
seriesstringsr_wxq9yq5v
namestringVisitor arrivals to Japan from Total
unitstringvisitors
periodstring2026-08
valuenumber3098900
year_beforenumber3428406
yoy_pctnumber-9.6

Measures

GET /v1/arrivals

data is a list of records.

FieldTypeExample
countrystringCL
seriesstringsr_gnvbx5rt
namestringCHL, _Z, ARRIVALS, PS, _T, _Z, TDS, A
unitstringPS
freqstringA
observationsarray[0 items]

GET /v1/nights

data is a list of records.

FieldTypeExample
countrystringCL
seriesstringsr_ay31rkhs
namestringCHL, TRIPS, PS, OVERNIGHT, _T, TDS, A
unitstringPS
freqstringA
observationsarray[0 items]

GET /v1/spend

data is a list of records.

FieldTypeExample
countrystringCL
seriesstringsr_qn2jpsb5
namestringTravel spending (debit), CHL, quarterly
unitstringUS dollars, x10^6
freqstringQ
observationsarray[3 items]
observations[].periodstring2025-Q4
observations[].valuenumber752348814.62
notestringThis series is not in a currency we c...

GET /v1/departures

data is a list of records.

FieldTypeExample
countrystringCL
seriesstringsr_r3pa07sb
namestringCHL, _Z, DEPARTURES, PS, _T, _Z, _Z, A
unitstringPS
freqstringA
observationsarray[0 items]

GET /v1/occupancy

data is a list of records.

FieldTypeExample
countrystringCL
seriesnull or valuenull
observationsarray[0 items]
notestringNo occupancy series held for CL.

GET /v1/capacity

data is a list of records.

FieldTypeExample
countrystringCL
seriesnull or valuenull
observationsarray[0 items]
notestringNo capacity series held for CL.

Breakdowns

GET /v1/arrivals/by-origin

data is a list of records.

FieldTypeExample
seriesstringsr_4zqx3d8x
namestringCanada, Non-resident visitors enterin...
unitstringVisitors
valuenumber4584611

GET /v1/nights/by-accommodation

data is a list of records.

FieldTypeExample
seriesstringsr_85g2v1ta
namestringTourist nights in Chile: hotels
unitstringnights
valuenumber1333264

GET /v1/nights/by-region

data is a list of records.

FieldTypeExample
seriesstringsr_d1jex8kh
namestringSLOVENIA
unitstring
valuenumber17843311

GET /v1/arrivals/by-purpose

data is a list of records.

FieldTypeExample
seriesstringsr_qv12q8ks
namestringThe Netherlands, All leisure accommod...
unitstringnumber
valuenumber40540800

GET /v1/origins/{iso}

data is a list of records.

FieldTypeExample
destinationstringCR
namestringCosta Rica
seriesstringsr_h1jk3ec9
unitstringtourists
freqstringM
periodstring2026-08
valuenumber1420

Compare and rank

GET /v1/compare

data is a list of records.

FieldTypeExample
periodstring2025-01
CLnull or valuenull
BAnull or valuenull
ATnumber3491284

GET /v1/rank

data is a list of records.

FieldTypeExample
rankinteger1
countrystringHU
namestringHungary
seriesstringsr_8dhrzswd
unitstring
periodstring2026-08
valuenumber6916472
year_beforenumber7340976
yoy_pctnumber-5.8

GET /v1/growth

data is a list of records.

FieldTypeExample
countrystringCL
notestringNo arrivals figure held for CL at tha...

GET /v1/share

data is one record.

FieldTypeExample
countrystringAT
originstringDE
periodstring2026-08
share_pctnumber41.2
groupstringeurope

GET /v1/seasonality

data is a list of records.

FieldTypeExample
monthinteger1
indexnumber106.3
lownumber106.3
highnumber106.3

GET /v1/movers

data is one record.

FieldTypeExample
risingarray[3 items]
rising[].countrystringNC
rising[].namestringNew Caledonia
rising[].seriesstringsr_ne8xpxnt
rising[].unitstringtourists
rising[].periodstring2026-08
rising[].valuenumber6786
rising[].year_beforenumber5260
rising[].yoy_pctnumber29
fallingarray[3 items]
falling[].countrystringPE
falling[].namestringPeru
falling[].seriesstringsr_41hhx4bx
falling[].unitstringtourists
falling[].periodstring2026-06
falling[].valuenumber258156
falling[].year_beforenumber278218
falling[].yoy_pctnumber-7.2

GET /v1/records

data is a list of records.

FieldTypeExample
countrystringBE
namestringBelgium
seriesstringsr_6vm9se5n
unitstringNumber
record_periodstring2026-07
record_valuenumber2126258
latest_periodstring2026-07
latest_valuenumber2126258
pct_of_recordnumber100
latest_is_recordbooleantrue

Statistics

GET /v1/stats/trend

data is a list of records.

FieldTypeExample
periodstring2018-09
adjustednumber2493188.1

GET /v1/stats/recovery

data is a list of records.

FieldTypeExample
periodstring2020-01
indexnumber98.95

GET /v1/stats/benchmark

data is a list of records.

FieldTypeExample
yearstring2015
countrynumber61.9
regionnumber74.9

GET /v1/stats/stay-length

data is a list of records.

FieldTypeExample
periodstring2026-07
nights_per_arrivalnumber2.18

GET /v1/stats/forecast

data is a list of records.

FieldTypeExample
periodstring2026-09
valuenumber2799576
lownumber2581010
highnumber3036651

GET /v1/stats/nowcast

data is a list of records.

FieldTypeExample
periodstring2026-09
valuenumber3090230
lownumber2848972
highnumber3351918
estimatedbooleantrue

GET /v1/stats/anomalies

data is a list of records.

FieldTypeExample
periodstring2020-03
scorenumber-6.6
expectednumber974204.6

GET /v1/stats/origin-shift

data is a list of records.

FieldTypeExample
originstringChina
share_pctnumber13.05
change_pointsnumber-9.58

GET /v1/stats/concentration

data is one record.

FieldTypeExample
hhiinteger1391
top3_share_pctnumber58.5
windowstring2025-09 to 2026-08
marketsinteger39
topobject{...}
top.South Koreanumber26.5
top.Taiwannumber18.9
top.Chinainteger13
top.United Statesnumber8.5
top.Hong Kongnumber6.6

GET /v1/stats/fx-sensitivity

data is a list of records.

FieldTypeExample
originstringUS
namestringUnited States
currencystringUSD
seriesstringsr_p4b6agqg
monthsinteger226
elasticitynumber-0.47
correlationnumber-0.28
readingstringA 10% dearer JPY for United States tr...

GET /v1/stats/tourism-intensity

data is a list of records.

FieldTypeExample
rankinteger1
countrystringAD
namestringAndorra
yearinteger2019
arrivals_per_residentnumber107.684
receipts_per_resident_usdnumber24976
arrivalsinteger8235000
populationinteger76474

Context

GET /v1/holidays

data is a list of records.

FieldTypeExample
countrystringAT
datestring2025-01-01
namestringNew Year's Day
local_namestringNeujahr
nationalbooleantrue

GET /v1/holidays/{iso}

data is a list of records.

FieldTypeExample
countrystringCL
datestring2026-01-01
namestringNew Year's Day
local_namestringAño Nuevo
nationalbooleantrue

GET /v1/fx

data is a list of records.

FieldTypeExample
quotestringAUD
basestringEUR
datestring2026-10-13
ratenumber1.6033

GET /v1/fx/{currency}

data is a list of records.

FieldTypeExample
quotestringTHB
basestringEUR
datestring2025-10-20
ratenumber38.106

GET /v1/convert

data is a list of records.

FieldTypeExample
periodstring2025-01
valuenumber102.5
ratenumber1.035373

GET /v1/joins/holidays

data is a list of records.

FieldTypeExample
periodstring2025-01
valuenumber3781629
holidaysinteger2
holiday_listarray[2 items]
holiday_list[].datestring2025-01-01
holiday_list[].namestringNew Year's Day

GET /v1/holidays/upcoming

data is a list of records.

FieldTypeExample
countrystringCL
datestring2026-10-31
namestringReformation Day
local_namestringDía Nacional de las Iglesias Evangéli...
nationalbooleantrue
in_daysinteger11

GET /v1/fx/latest

data is a list of records.

FieldTypeExample
quotestringUSD
ratenumber1.1225

GET /v1/fuel

data is a list of records.

FieldTypeExample
monthstring2025-01
jet_fuel_usd_gallonnumber2.347
jet_fuel_usd_litrenumber0.62
jet_fuel_indexnumber125
jet_fuel_yoy_pctnumber-9.2
crude_usd_barrelnumber79.27
crude_indexnumber123.2
crude_yoy_pctnumber-1.1

GET /v1/fuel/latest

data is a list of records.

FieldTypeExample
monthstring2026-09
jet_fuel_usd_gallonnumber4.388
jet_fuel_usd_litrenumber1.159
jet_fuel_indexnumber233.7
jet_fuel_yoy_pctnumber110.1
crude_usd_barrelnumber114.16
crude_indexnumber177.4
crude_yoy_pctnumber67.9

GET /v1/economy/{iso}

data is a list of records.

FieldTypeExample
yearinteger2031
projectionbooleantrue
gdp_growth_pctnumber2.3
inflation_pctnumber3
gdp_usd_bnnumber486.5
gdp_per_capita_usdnumber23676
population_mnumber20.55
unemployment_pctnumber7.8
current_account_pct_gdpnumber-1.5

GET /v1/economy/{iso}/tourism

data is a list of records.

FieldTypeExample
yearinteger2025
receipts_usdnumber3844116835
spending_abroad_usdnumber3152653820
arrivalsnull or valuenull
receipts_per_arrival_usdnull or valuenull
receipts_share_gdp_pctnumber1.08

GET /v1/economy/outlook

data is a list of records.

FieldTypeExample
countrystringCL
namestringChile
gdp_growth_2026number0.6
inflation_2026number3.7
gdp_growth_2027number2.6
inflation_2027number3.5
gdp_growth_2028number2.4
inflation_2028number3

Releases

GET /v1/releases

data is a list of records.

FieldTypeExample
datestring2026-10-18
countrystringAT
series_updatedinteger1968
latest_periodstring2026-Q1
measuresarray[3 items]

GET /v1/releases/latest

data is a list of records.

FieldTypeExample
datestring2026-10-19
countrystringHU
series_updatedinteger434
latest_periodstring2026-08
measuresarray[3 items]

GET /v1/freshness

data is a list of records.

FieldTypeExample
isostringKI
namestringKiribati
lateststring2018-12
months_behindinteger94

GET /v1/gaps

data is a list of records.

FieldTypeExample
countrystringVN
namestringVietnam
measurestringarrivals
seriesstringsr_k2v8x0q1
firststring2008-01
lateststring2026-09
months_heldinteger220
months_missinginteger0
months_not_publishedinteger0
months_withheldinteger0
months_pendinginteger0
complete_pctnumber100
missingarray[0 items]
not_publishedarray[0 items]
withheldarray[0 items]
checked_atstring2026-10-14T12:00:00Z

GET /v1/calendar

data is a list of records.

FieldTypeExample
countrystringAT
namestringAustria
lateststring2026-08
next_periodstring2026-09
expected_instring2026-11
usual_delay_monthsinteger2
overduebooleanfalse

GET /v1/changelog

data is a list of records.

FieldTypeExample
datestring2026-10-14
changestringData gaps for every country, month by...

GET /v1/monitor

data is one record.

FieldTypeExample
monthstring2026-07
editionstringworld
titlestringWorld
built_atstring2026-10-19T15:42:30Z
headlineobject{...}
headline.countriesinteger71
headline.growinginteger52
headline.comparedinteger71
headline.yoy_pctinteger4
headline.vs_2019_pctnumber104.5
headline.recordsinteger13
headline.trustinteger99
regionsarray[3 items]
regions[].regionstringamericas
regions[].namestringAmericas
regions[].countriesinteger10
regions[].yoy_pctnumber4.1
regions[].vs_2019_pctnumber101.1
risingarray[3 items]
rising[].countrystringXK
rising[].namestringKosovo
rising[].regionstringeurope
rising[].measurestringarrivals
rising[].unitstringNumber
rising[].seriesstringsr_zqr55sk9
rising[].basisstringstays
rising[].valueinteger66955
rising[].year_beforeinteger50825
rising[].yoy_pctnumber31.7
rising[].vs_2019_pctnull or valuenull
rising[].series_breakbooleantrue
rising[].pct_of_recordinteger100
rising[].recordbooleantrue
fallingarray[3 items]
falling[].countrystringAU
falling[].namestringAustralia
falling[].regionstringasia-pacific
falling[].measurestringarrivals
falling[].unitstringNUM
falling[].seriesstringsr_bgakrnej

GET /v1/monitor/editions

data is a list of records.

FieldTypeExample
monthstring2026-08
editionstringafrica
countriesinteger3
statusstringcomplete
built_atstring2026-10-19T15:42:30Z

GET /v1/monitor/paper

data is one record.

FieldTypeExample
monthstring2026-07
issueinteger139
referencestringTAPI-WTM-2026-07-WLD
titlestringWorld Tourism Monitor, July 2026
built_atstring2026-10-19T15:43:15Z
edition_built_atstring2026-10-19T15:42:30Z
citestringTourism API (2026). World Tourism Mon...
briefstringInternational arrivals moved +4.0% on...
kfarray[3 items]
kf[].0stringAgainst July 2019
kf[].1string104.5%
kf[].2string
key_findingsarray[3 items]
sectionsarray[3 items]
sections[].nointeger26
sections[].kickstringAppendix B
sections[].titlestringEconomic tables
sections[].dekstringGrowth, inflation, unemployment and o...
sections[].paragraphsarray[0 items]
sections[].figuresarray[0 items]
sections[].tablesarray[1 items]
factsarray[3 items]
figuresarray[3 items]
figures[].nointeger19
figures[].titlestringThe world figure for the next three m...
figures[].unitstringChange on a year, %
figures[].typestringband
figures[].dataobject{...}
figures[].data.monthsarray[3 items]
figures[].data.valuearray[3 items]
figures[].data.lowarray[3 items]
figures[].data.higharray[3 items]
figures[].sourcestringTourism API, /v1/stats/forecast, comb...
figures[].callstring/v1/stats/forecast?country=ES&horizon=3
tablesarray[3 items]
tables[].nointeger21
tables[].titlestringEconomic figures by country
tables[].headarray[3 items]
tables[].rowsarray[3 items]
tables[].rows[].0string5.5

GET /v1/monitor/index

data is a list of records.

FieldTypeExample
monthstring2025-01
countriesinteger90
yoy_pctnumber13.4
vs_2019_pctnumber109.8
growinginteger69
comparedinteger88
recordsinteger8
trustinteger97

GET /v1/monitor/trust

data is a list of records.

FieldTypeExample
countrystringLK
namestringSri Lanka
regionstringasia-pacific
measurestringarrivals
seriesstringsr_mman287y
freshinteger100
completeinteger38
stableinteger100
officialinteger100
scoreinteger81
gradestringB

Bulk 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.

FieldTypeExample
filestringall.zip
countriesinteger199
built_atstring2026-10-12T09:41:07Z
manifeststring/v1/bulk/manifest.json

GET /v1/units

data is one record.

FieldTypeExample
countsarray[3 items]
counts[].unitstringnights
counts[].scaleinteger1
ratesarray[2 items]
rates[].unitstringpercent
rates[].scaleinteger1
currenciesarray[3 items]
periodsarray[3 items]

GET /v1/usage

data is one record.

FieldTypeExample
todayinteger214
monthinteger3880
by_endpointobject{...}
by_endpoint./v1/arrivalsinteger120
by_endpoint./v1/series/{id}/observationsinteger94

GET /v1/status

data is one record.

FieldTypeExample
okbooleantrue
last_loadstring2026-10-20T04:14:01Z
countriesinteger214
monthly_countriesinteger125
monthly_within_2_monthsinteger55
endpoints_liveinteger75
status_pagestringhttps://tourismapi.com/status