We present to you the documentation for the Is It Safe to Visit? 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)
Example RequestTo get a list of the travel advisories for Thailand in XML foramt, you'd enter this URL:
Example ResponseHere'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
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
|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|