API Documentation

14 endpoints. 195 countries. Structured JSON. Everything you need to integrate travel risk data into your application.

Download as Markdown — point your LLM here

Quick Start

Get your API key from the pricing page, then make your first request:

curl -H "Authorization: Bearer ta_live_abc123..." \
  "https://api.traveladvisory.io/v1/advisory?code=CO"

That returns the full travel advisory for Colombia, including State Department level, restricted areas, entry requirements, and source timestamps. All in JSON.

Authentication

Every request requires a Bearer token in the Authorization header.

Authorization: Bearer ta_live_abc123def456...

Keys start with ta_live_ followed by 32 hex characters. Keep your key private. Do not commit it to version control or expose it in client-side code.

Requests without a valid key return 401 Unauthorized.

Rate Limits

Every response includes rate limit headers:

X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4832
X-RateLimit-Reset: 1711929600

Tier	Monthly Requests	Rate Limit	Price
Free	250 total	10 req/min	No credit card required
Builder	5,000/mo	60 req/min	$29/mo
Pro	25,000/mo	200 req/min	$79/mo
Scale	100,000/mo	500 req/min	$199/mo

Exceeding your limit returns 429 Too Many Requests with your current usage in the response body. No surprise charges.

Endpoints

Core Advisory

Travel advisories, country listings, and change tracking.

GET/v1/advisory GET/v1/countries GET/v1/countries-by-level GET/v1/changes

Country Intelligence

Freedom scores, political stability, geography, culture, economy, and demographics.

GET/v1/freedom GET/v1/political-stability GET/v1/geography GET/v1/culture GET/v1/economy GET/v1/demographics

Health & Safety

Vaccinations, disease risks, traveler impact assessments, and packing suggestions.

GET/v1/vaccinations GET/v1/traveler-impact GET/v1/packing-list

Bulk & Comparison

Compare multiple countries in a single request.

GET/v1/compare

Core Advisory

Travel advisories, country listings, and change tracking.

Get Travel Advisory

GET/v1/advisory

Full advisory data for a country. Includes State Department level, reasons, restricted areas, entry/exit requirements, and area-specific warnings.

Parameters

coderequiredISO 3166-1 alpha-2 country code (e.g., "CO", "JP")

Example Request

curl -H "Authorization: Bearer ta_live_..." \
  "https://api.traveladvisory.io/v1/advisory?code=CO"

Response

Returns advisory level (1-4), advisory text, restricted areas, entry/exit info, and source timestamps.

List All Countries

GET/v1/countries

Returns all 195 countries with their ISO code, name, flag emoji, and current advisory level.

Example Request

curl -H "Authorization: Bearer ta_live_..." \
  "https://api.traveladvisory.io/v1/countries"

Response

Array of country objects. Each includes code, name, flag, and advisory level.

Countries by Advisory Level

GET/v1/countries-by-level

All countries at a specific advisory level. Useful for building maps or filtering dashboards.

Parameters

levelrequiredAdvisory level: 1 (Exercise Normal Precautions), 2 (Exercise Increased Caution), 3 (Reconsider Travel), 4 (Do Not Travel)

Example Request

curl -H "Authorization: Bearer ta_live_..." \
  "https://api.traveladvisory.io/v1/countries-by-level?level=4"

Response

Array of countries matching the requested advisory level.

Advisory Changes Feed

GET/v1/changes

Track advisory level changes over a date range. Defaults to the last 7 days if no dates are provided.

Parameters

sinceoptionalStart date in YYYY-MM-DD format (default: 7 days ago)

untiloptionalEnd date in YYYY-MM-DD format (default: today)

Example Request

curl -H "Authorization: Bearer ta_live_..." \
  "https://api.traveladvisory.io/v1/changes?since=2026-03-01&until=2026-03-10"

Response

Array of change objects with country, previous level, new level, and change date.

Country Intelligence

Freedom scores, political stability, geography, culture, economy, and demographics.

Freedom House Data

GET/v1/freedom

Freedom House scores for a country. Includes aggregate freedom score (0-100), political rights (1-7), civil liberties (1-7), and freedom status.

Parameters

coderequiredISO 3166-1 alpha-2 country code

Example Request

curl -H "Authorization: Bearer ta_live_..." \
  "https://api.traveladvisory.io/v1/freedom?code=JP"

Response

Returns freedom_score, political_rights, civil_liberties, and status ("Free", "Partly Free", "Not Free").

Political Stability (World Bank WGI)

GET/v1/political-stability

World Bank Worldwide Governance Indicators. Six dimensions: rule of law, control of corruption, political stability, government effectiveness, voice and accountability, regulatory quality.

Parameters

coderequiredISO 3166-1 alpha-2 country code

Example Request

curl -H "Authorization: Bearer ta_live_..." \
  "https://api.traveladvisory.io/v1/political-stability?code=BR"

Response

Returns six governance indicators, each scored from approximately -2.5 (weak) to +2.5 (strong).

Geographic Data

GET/v1/geography

Geographic information for a country.

Parameters

coderequiredISO 3166-1 alpha-2 country code

Example Request

curl -H "Authorization: Bearer ta_live_..." \
  "https://api.traveladvisory.io/v1/geography?code=AU"

Response

Returns geographic data including region, subregion, coordinates, and borders.

Cultural Information

GET/v1/culture

Cultural data for a country.

Parameters

coderequiredISO 3166-1 alpha-2 country code

Example Request

curl -H "Authorization: Bearer ta_live_..." \
  "https://api.traveladvisory.io/v1/culture?code=IT"

Response

Returns cultural information including languages, religions, customs, and etiquette.

Economic Indicators

GET/v1/economy

Economic data for a country.

Parameters

coderequiredISO 3166-1 alpha-2 country code

Example Request

curl -H "Authorization: Bearer ta_live_..." \
  "https://api.traveladvisory.io/v1/economy?code=DE"

Response

Returns GDP, inflation, currency, trade data, and economic indicators.

Demographic Data

GET/v1/demographics

Population and demographic information for a country.

Parameters

coderequiredISO 3166-1 alpha-2 country code

Example Request

curl -H "Authorization: Bearer ta_live_..." \
  "https://api.traveladvisory.io/v1/demographics?code=NG"

Response

Returns population, age distribution, urbanization, literacy, and life expectancy.

Health & Safety

Vaccinations, disease risks, traveler impact assessments, and packing suggestions.

Health & Vaccination Data

GET/v1/vaccinations

Required and recommended vaccinations, malaria information, disease risks, and active health notices for a country.

Parameters

coderequiredISO 3166-1 alpha-2 country code

Example Request

curl -H "Authorization: Bearer ta_live_..." \
  "https://api.traveladvisory.io/v1/vaccinations?code=KE"

Response

Returns required_vaccines, recommended_vaccines, malaria_info, disease_risks, and health_notices arrays.

Traveler Impact Assessment

GET/v1/traveler-impact

Risk assessment broken down by traveler type: solo, business, family, and remote worker. Includes consular support availability and severity scores.

Parameters

coderequiredISO 3166-1 alpha-2 country code

Example Request

curl -H "Authorization: Bearer ta_live_..." \
  "https://api.traveladvisory.io/v1/traveler-impact?code=TH"

Response

Returns per-type risk profiles with severity scores, consular support info, and specific recommendations.

Packing List Suggestions

GET/v1/packing-list

Suggested packing list items based on country conditions, climate, and advisory level.

Parameters

coderequiredISO 3166-1 alpha-2 country code

Example Request

curl -H "Authorization: Bearer ta_live_..." \
  "https://api.traveladvisory.io/v1/packing-list?code=IS"

Response

Returns categorized packing suggestions based on destination conditions.

Bulk & Comparison

Compare multiple countries in a single request.

Compare Countries

GET/v1/compare

Compare up to 4 countries side by side. Returns advisory data, freedom scores, stability indicators, and health info for each country in a single response.

Parameters

codesrequiredComma-separated ISO codes, 2-4 countries (e.g., "CO,JP,DE,TH")

Example Request

curl -H "Authorization: Bearer ta_live_..." \
  "https://api.traveladvisory.io/v1/compare?codes=CO,JP,DE"

Response

Returns an object keyed by country code, each containing full advisory and risk data.

Error Codes

Status	Meaning	What to Do
400	Bad Request	Check your query parameters. Missing or invalid country code.
401	Unauthorized	Your API key is missing or invalid.
403	Forbidden	Your key does not have access to this endpoint or tier.
404	Not Found	The country code does not match any known country.
429	Too Many Requests	You hit your rate limit. Check X-RateLimit-Reset for when to retry.
500	Internal Server Error	Something broke on our end. Retry after a few seconds.

Ready to start building?

250 free requests. No credit card. Get your key in 10 seconds.

Get your API key