Developer API

We present to you the documentation for the Is It Safe to Visit? API.

Simple API

The Simple API is a fairly simple interface to get current status advisory data for any country. You can currently retrieve data in XML format.

Forming the Country Status Request URL

To find a country name to use in the "countryname" field, use the countryname from the URL for that country. (ie. for Thailand, the URL is normally http://isitsafetovisit.com/Thailand)

http://isitsafetovisit.com/countryname.xml

Example Request

To get a list of the travel advisories for Thailand in XML foramt, you'd enter this URL:

http://isitsafetovisit.com/Thailand.xml

Example Response

Here's an example of the XML response from a country status call:

	
	
	  Thailand
	  
	    2008-11-20T20:58:44Z
	    Really High Risk
	    1976
	    
	    4
	    2008-11-20T20:58:44Z
	
	    
	      
	        2008-11-20T20:58:44Z
	        High degree of caution
	        1977
	        1976
	        3
	        2008-11-20T20:58:44Z
	        Australia Smart Traveller
	        http://www.smartraveller.gov.au/zw-cgi/view/Advice/Thailand
	      

	      
	        2008-11-20T20:58:44Z
	        Exercise high degree of caution
	        1978
	        1976
	        3
	        2008-11-20T20:58:44Z
	        Canadian Foreign Affairs Department
	        http://www.voyage.gc.ca/dest/report-en.asp?country=290000
	      
	
	      
	        2008-11-20T20:58:44Z
	        Extreme risk
	        1979
	        1976
	        5
	        2008-11-20T20:58:44Z
	        New Zealand Safe Travel
	        http://safetravel.govt.nz/destinations/thailand.shtml
	      
	
	      
	        2008-11-20T20:58:44Z
	        Country Specific Information
	        1980
	        1976
	        
	        2008-11-20T20:58:44Z
	        U.S. Department of State
	        http://travel.state.gov/travel/cis_pa_tw/cis/cis_1040.html

Response Data

There are a few different types of responses -- Full advisory information (all the advisories about a country, including the IISTV advisory rating), or Individual advisory information issued by a specific country (for example, New Zealand Safe Travel).

Full Advisory Information

Individual Advisory Information

Need to get this parameter information from Brent.

XML

We provide the XML version of the data in a simple XML format.

overall-status	All information about the country status is contained within this element.
statuses	This element contains the status advisories segmented by issuing country.
status	This describes the country whose status message you are reading (ie. "AustraliaStatus" for the an advisory from Australia)
name	Full name of the country
created-at	Date of the last country status calculation
description	Plain english version of the country status advisory level
id	Internal tracking number of the country advisory
parent-id	Internal tracking number of the parent advisory (when applicable)
rating	Integer version of the country status advisory level, ranging from 1 to 5
updated-at	Date of the last country status calculation
name	Name of the country giving the advisory
url	URL of the referenced country advisory