State Department · Schema

TravelAdvisory

A country travel advisory issued by the US Department of State Consular Affairs Data API

US GovernmentTravelPassportsVisasTravel AdvisoriesConsular AffairsForeign PolicyDiplomaticCountry InformationPublic Safety

Properties

Name Type Description
Title string Advisory title including country name and warning level (e.g., 'Nigeria - Level 3: Reconsider Travel')
Link string URL to the full advisory page on travel.state.gov
Category array Array of two-letter ISO 3166-1 alpha-2 country codes associated with this advisory
Summary string HTML-formatted summary of the advisory including risk categories such as crime, terrorism, health threats, civil unrest, and kidnapping
id string Unique identifier for the advisory, typically the same as the Link URL
Published string ISO 8601 timestamp of when the advisory was first published
Updated string ISO 8601 timestamp of the last update to the advisory
Advisory_Level integer Numeric alert level: 1=Exercise Normal Precautions, 2=Exercise Increased Caution, 3=Reconsider Travel, 4=Do Not Travel
Key_Risks array Array of key risk categories associated with the advisory (returned for single-country queries)
View JSON Schema on GitHub

JSON Schema

travel-advisory.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/state-dept/main/json-schema/travel-advisory.json",
  "title": "TravelAdvisory",
  "description": "A country travel advisory issued by the US Department of State Consular Affairs Data API",
  "type": "object",
  "properties": {
    "Title": {
      "type": "string",
      "description": "Advisory title including country name and warning level (e.g., 'Nigeria - Level 3: Reconsider Travel')",
      "example": "Niger - Level 4: Do Not Travel"
    },
    "Link": {
      "type": "string",
      "format": "uri",
      "description": "URL to the full advisory page on travel.state.gov"
    },
    "Category": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 2,
        "maxLength": 2,
        "pattern": "^[A-Z]{2}$"
      },
      "description": "Array of two-letter ISO 3166-1 alpha-2 country codes associated with this advisory"
    },
    "Summary": {
      "type": "string",
      "description": "HTML-formatted summary of the advisory including risk categories such as crime, terrorism, health threats, civil unrest, and kidnapping"
    },
    "id": {
      "type": "string",
      "description": "Unique identifier for the advisory, typically the same as the Link URL"
    },
    "Published": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601 timestamp of when the advisory was first published"
    },
    "Updated": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601 timestamp of the last update to the advisory"
    },
    "Advisory_Level": {
      "type": "integer",
      "minimum": 1,
      "maximum": 4,
      "description": "Numeric alert level: 1=Exercise Normal Precautions, 2=Exercise Increased Caution, 3=Reconsider Travel, 4=Do Not Travel"
    },
    "Key_Risks": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of key risk categories associated with the advisory (returned for single-country queries)"
    }
  },
  "required": ["Title", "Link", "Category", "Summary", "id", "Published", "Updated"],
  "examples": [
    {
      "Title": "Niger - Level 4: Do Not Travel",
      "Link": "https://travel.state.gov/content/travel/en/traveladvisories/traveladvisories/niger-travel-advisory.html",
      "Category": ["NG"],
      "Summary": "The U.S. State Department advises against all travel to Niger due to multiple critical threats.",
      "id": "https://travel.state.gov/content/travel/en/traveladvisories/traveladvisories/niger-travel-advisory.html",
      "Published": "2025-10-30T20:00:00-04:00",
      "Updated": "2025-10-30T20:00:00-04:00",
      "Advisory_Level": 4,
      "Key_Risks": [
        "Terrorism and kidnapping",
        "Violent crime",
        "Civil unrest",
        "Limited medical services"
      ]
    }
  ]
}