Travel advisories (US State + UK FCDO)

CEV-OS / Data API / Travel advisories (US State + UK FCDO)

CEV-OS Data API · last updated 2026-11-04. Status: live. Version 1.

Use this when you need the current US State Department and UK FCDO travel-advisory level for a country, or the list of countries at or above a level.

What it is

Country-level travel advisories: the higher of the US State Department (1-4) and UK FCDO (mapped to the same 1-4 scale) for each ISO 3166-1 alpha-2 country, plus each source's own level and the UK advice text. No coordinates. UK data is published under the Open Government Licence v3.0. Not an official warning from cev-os.

Endpoints

REST: GET /v1/travel-advisories on https://api.cev-os.com
Legacy host (same service): GET /v1/travel-advisories on https://cev-os.com
MCP tool: get_travel_advisories on https://mcp.cev-os.com/mcp

Parameters

Query parameters for `GET /v1/travel-advisories`
Name	Type	Description	Constraints
`country`	string	ISO 3166-1 alpha-2 country code.	example NG; pattern ^[A-Za-z]{2}$
`min_level`	integer	List only: minimum combined level 1-4 (default 1).	example 3; min 1; max 4

Example request

No account and no key. Query values below are the examples or defaults from the registry. An optional free key (header x-api-key) raises the limits; create one at https://cev-os.com/#api_keys after signing in with a verified email (Google sign-in is already verified).

curl -s "https://api.cev-os.com/v1/travel-advisories?country=NG&min_level=3"

Example response

Every /v1 response is a JSON envelope (schema_version, product, timestamps, license, attribution, data). The registry example is the data member:

{
  "count": 1,
  "advisories": [
    {
      "country": "NG",
      "country_name": "Nigeria",
      "level": 3,
      "us_level": 3,
      "uk_level": 3,
      "uk_advice": "Advise against all/all-but-essential travel (whole country or parts)",
      "url": "https://travel.state.gov/"
    }
  ]
}

Update frequency

TRIPWIRE refreshes US State + UK FCDO every 6 h; Data API caches 1 h.

Public cache: 3600 seconds (Cache-Control: public, max-age=3600).

Sources, license and usage

License status: cleared with attribution. US State Department: US Government work. UK FCDO: Open Government Licence v3.0 (attribution required).

Underlying sources
Source	License	commercialOk	Terms
U.S. Department of State travel advisories	US Government work (public domain)	true	—
UK Foreign, Commonwealth & Development Office	Open Government Licence v3.0	true	https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/

Attribution (show this wherever you display the data):

US Department of State (travel.state.gov).
Contains public sector information licensed under the Open Government Licence v3.0 (FCDO, https://www.gov.uk/foreign-travel-advice).

Open Government Licence v3.0

Privacy class: public-derived. Access: public. Price: free (price is null; pay-per-call is not active).

Disclaimer

Not an official warning from cev-os. Follow the US State Department and UK FCDO for official travel advice.

Data API hub (all products, limits, license notes)
MCP Registry listing com.cev-os/data
OpenAPI 3.1
Machine product list: /v1/products
CEV-OS TRIPWIRE incidents (explainer)

Reference data, not investment advice.