CitedTravel

DoesTells a traveller whether they need a plug adapter orand/or a voltage converter?converter verdictin {adapter:another not_neededcountry. |Use neededit |for depends_on_plug"will my charger work there?".
For the raw plug, converter:voltage not_neededand |frequency usually_not_neededfacts |use needed_for_single_voltage_devicesget_country_facts; |for unknown,a plug_fit[],whole frequency_note,trip guidance}use get_trip_brief, computedwhich fromincludes citedthis plug,verdict voltageper anddestination.
Computed frequencyfrom factscited (inputs[]plug, with sourcesvoltage and confidence;frequency top-levelfacts; confidence is theirthe lowest). of those inputs. Plug fit is conservative. ForWithout rawvoltage powerdata factsthe useconverter get_country_facts;verdict is unknown; missing plug data for either country, or an unknown code, is a wholenot-found triperror. get_trip_briefKeyless; (includesa thisfree verdictkey peror destinationx402 lifts the limits (https://citedtravel.com/pricing/).
Parameters: home_country is where the devices were bought (their plugs and voltage rating), not nationality; destination is where they  ⟨5 unchanged words⟩ home_country":"GB","destination":"US"}.
Read-only; keyless (free key or x402 lifts limits: https://citedtravel.com/pricing/); errors RFC 9457.

{"properties":{"destination":{"description":"DestinationCountry countrywhere the devices will be plugged in as an ISO 3166-1 alpha-2 or alpha-3 code, ⟨29 unchanged words⟩ {"description":"Country where the traveller's devices comewere frombought (sets their plug type and voltage rating) as an ISO 3166-1 alpha-2 or alpha-3 code ⟨85 unchanged words⟩ 

Several citedCited facts for one country in onea single call: power, currency, emergency numbers, driving side, this year's public holidays, tipping (data.<category>.<field>; a category without data isand {}).tipping. Use it for a country overview. 
For one topic use get_emergency_numbers, get_tipping_norms, get_public_holidays  ⟨7 unchanged words⟩  for a whole trip get_trip_brief; for visas check_entry_requirements.
A Eachcategory factwith no data for the country comes back as an empty object; an unknown country code is cited:a sources[]not-found (url,error. license),Keyless; last_verified,a confidence.free key or x402 lifts the limits (https://citedtravel.com/pricing/).
Parameters: alpha-2 country codes workas bestalpha-2 (alpha-3 too;works; names via resolve_country). RequestAsk only for the categories you needneed; toomitted keepor the[] answermeans small.all six. Examples: {"country":"JP"}, {"country":"FRA","categories":["power","currency"]}.
Read-only; keyless (free key or x402 lifts limits: https://citedtravel.com/pricing/); errors RFC 9457.

{"properties":{"categories":{"description":"Categories to return; omit or pass [] for all six. holidays here means the current calendar year (use get_public_holidays for other dates).","examples":[["power","currency"] ⟨11 unchanged words⟩ "array"},"country":{"description":"Country to describe as an ISO 3166-1 alpha-2 or alpha-3 code ⟨84 unchanged words⟩ 

Emergency numbers forCited oneemergency country:phone data.numbers.valuenumbers {(police, ambulance, fire, general,) all_numbers};for one country. Use it when only these numbers are needed.
For several facts about the country use get_country_facts; for a servicewhole withouttrip itsget_trip_brief, ownwhich numberincludes these numbers per destination.
A role is null (usewhen general).the Usesource assigns it whenno onlynumber theseof numbersits own; often all four are needed;null get_country_factsand foronly severalall_numbers factslists the numbers. So use the role, get_trip_briefelse forgeneral, aelse wholeall_numbers; trip.never Noguess. A country with no emergency data, foror thean countryunknown code, is a not-found error.error, Eachnot factan isempty cited:result. sources[]Keyless; (url,a license),free last_verified,key confidence.or x402 lifts the limits (https://citedtravel.com/pricing/).
Parameters: country is where the call will be made (the traveller's current location, not home); alpha-2 works best.. Example: {"country":"JP"}.
Read-only; keyless (free key or x402 lifts limits: https://citedtravel.com/pricing/); errors RFC 9457.

{"properties":{"country":{"description":"Country where the emergency call will be made (the traveller's current location) as an ISO 3166-1 alpha-2 or alpha-3 code, ⟨84 unchanged words⟩ 

NationalCited national public holidays between two dates: data.holidays[] {date, name} by date, plusin one citation percountry yearbetween intwo data.facts[].dates. Use it to check travel dates for closures and crowds; crowds.
get_country_facts has only this year's list (with other facts,); get_trip_brief coversgives athe wholeholidays trip.for every stop of a trip.
Data spanscovers the current year and the next twotwo; (a range outside: that returns an empty list pluswith a coverage_note);, not an error. National holidays only, no regional holidays.ones. EachAn factunknown country code is cited:a sources[]not-found (url,error. license),Keyless; last_verified,a confidence.free key or x402 lifts the limits (https://citedtravel.com/pricing/).
Parameters: from and to are inclusive:inclusive; pass the travel dates, or YYYY-01-01 to YYYY-12-31 for a year. Overto twobefore yearsfrom, or toa beforerange fromover two years, is an error. Example: {"country":"JP","from":"2026-12-28","to":"2027-01-05"}.
Read-only; keyless (free key or x402 lifts limits: https://citedtravel.com/pricing/); errors RFC 9457.

{"properties":{"country":{"description":"Country whose national public holidays to list as an ISO 3166-1 alpha-2 or alpha-3 code, ⟨147 unchanged words⟩ 

TippingCited tipping customs for one country: data.norms.value {overall_context, situations {<situation>: {expectation, guidance_type, percent_min, percent_max}}}; percentages only where aoverall sourceand statesper them.situation. Use it for "should I tip, and how much?"; get_country_facts for.
For several facts, get_trip_briefabout the country use get_country_facts; for a whole trip.trip Customget_trip_brief.
Percentages are null unless a source states them; customs, not law:, and confidence reflects that. EachNo facttipping isdata cited:for sources[]the (urlcountry, license),or last_verifiedan unknown code, confidence.is a not-found error. Keyless; a free key or x402 lifts the limits (https://citedtravel.com/pricing/).
Parameters: omit situation for all;all onesituations; situationwith returnssituation, only that (noone is returned, and a situation without data gives empty situations, not an error).error. Examples: {"country":"US"}, {"country":"JP","situation":"taxi"}.
Read-only; keyless (free key or x402 lifts limits: https://citedtravel.com/pricing/); errors RFC 9457.

{"properties":{"country":{"description":"Country where the tip would be given as an ISO 3166-1 alpha-2 or alpha-3 code, ⟨106 unchanged words⟩ ","taxi","hotel_staff","tour_guides","bar"],"examples":["taxi"],"type":"string"}},"required" ⟨3 unchanged words⟩ 

Whole-tripOne brief for a trip of 1-5 destinations: per destinationstop, in order, entry (as check_entry_requirements, if passport is given), poweradapter/converter verdict from home_country, currency, emergency numbers, driving side, tipping and holidays between fromduring andthe to.trip. Use it to plan or summarise a trip; fortrip.
For one facttopic use check_entry_requirements, check_power_compatibility, get_emergency_numbers, get_tipping_norms or get_public_holidays, and get_country_factsget_public_holidays; for one country without dates.dates, get_country_facts.
No passport: entry null, nois advisory.null. IfA onestop destination'swhose entry can't be answered (passport unknown or outside the pilot, no data, same country) it isgets {unavailable: reason} and; the rest still returns. power is null at ⟨10 unchanged words⟩ }. An unknown home or destination code, over 5 destinations or a bad date range, fails the call. EachShow factthe isadvisory. cited:Needs sources[]a (url,free license)API key or x402, last_verifiedcharged per call, confidence.not Showper thedestination advisory.(https://citedtravel.com/pricing/).
Parameters: passport = nationality (optional); home_country = where traveller and devices come from; destinations in travel order, (home only if it is a stop;stop); from/to = whole trip, inclusive. Example: { ⟨7 unchanged words⟩ from":"2026-12-28","to":"2027-01-05"}.
Read-only; free API key or x402, charged per call, not per destination (https://citedtravel.com/pricing/); errors RFC 9457.

Dataset change feed, newest first: data[] {changed_on, fact_id,Feed country,of category,dataset change:changes (added |, updated | removed, old_valueremoved), new_value,newest source_url}.first. Use it to refresh caches or alert users when a fact changes, thenchanges.
Then fetch the current cited value (sources, license, confidence) with the matching tool, e.g. get_country_facts, get_public_holidays or check_entry_requirements.
since Entryis rowsinclusive: country is therows destination,with fact_idchanged_on ison entry:<passport>-><destination>.
Parameters:or setafter sinceit, toso the last changed_onday you processed (inclusive:comes thatback dayagain. repeats).old_value Filteris bynull categoryfor and/oradded country;rows, exactlynew_value for removed ones. No match is an empty list, not an error; an unknown country code is a not-found error. Exactly limit rows means older onesrows weremay cut,have sobeen cut: raise limit (max 500) or narrow.narrow the filters. For entry facts, country is the destination. Keyless; a free key or x402 lifts the limits (https://citedtravel.com/pricing/).
Parameters: since = the last changed_on you processed; filter by category and/or country. Examples: {"since":"2026-10-01"}, {"since":"2026-10-01","category":"entry","country":"JP"}.
Read-only; keyless (free key or x402 lifts limits: https://citedtravel.com/pricing/); errors RFC 9457.

 ⟨8 unchanged words⟩  (entry = visa/entry pilot). Omit for all.all categories.","enum":["power","currency","emergency","driving","holidays","tipping","entry"],"examples":["entry"],"type":"string"},"country":{"description" ⟨53 unchanged words⟩  first. Default 100; values are clamped to 1-500, (numericand 0, an empty or a non-numeric value means 100. Numeric strings such as \"50\" are accepted).accepted.","examples":[50],"type":["integer","string"]},"since":{"description":"Return changes recorded on or after this date.date (inclusive). Use the last changed_on you processed. Calendar date, YYYY-MM-DD.","examples":["2026-10-01 ⟨16 unchanged words⟩ 

Turns a country name, alias or code (English, Japanese, Chinese)Finds intothe ISO codes: matches[]for {iso2,a iso3,country name, score},alias bestor first,code maxwritten 5in English, emptyJapanese ifor none.Chinese. Call it first whenwhenever you only have a name:name.
The other tools (get_country_facts, check_entry_requirements, get_trip_brief, and...) take ISO codes; pass on the otherbest toolsmatch.
Ignores takecase, ISOspaces codes.and Exactpunctuation; matches exactly, by prefix (3+ charscharacters) or by substring (4+); matchup to 5 matches, ignoringbest casefirst. andNo punctuation;spelling correction: no spellingmatch correction.is Namesan onlyempty (CLDR):list, nonot sourcesan orerror. confidence.Free and keyless, no quota.
Parameters: pass query as the user wrote  ⟨5 unchanged words⟩ with the official or local name. lang only localizeschanges the language of the returned names. Examples: {"query":"日本"}, {"query":"South Korea","lang":"ja"}.
Read-only; free and keyless, no quota.