Is it safe to visit...?

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.
statusesThis element contains the status advisories segmented by issuing country.
statusThis describes the country whose status message you are reading (ie. "AustraliaStatus" for the an advisory from Australia)
nameFull name of the country
created-atDate of the last country status calculation
descriptionPlain english version of the country status advisory level
idInternal tracking number of the country advisory
parent-idInternal tracking number of the parent advisory (when applicable)
ratingInteger version of the country status advisory level, ranging from 1 to 5
updated-atDate of the last country status calculation
nameName of the country giving the advisory
urlURL of the referenced country advisory