Informationen about the API

Last Update: Monday, 15.10.2018

Description


Sime REST API in JSON format with the current status of travel warnings for most countries. Returns the current situation as based on current information. For single countries or all at once. Further information about the data used can be found on the FAQ page. Data is updated daily and is available at 7.30 am German time (Timezone Germany/Berlin). A single request per day is sufficient.

Type of API
REST JSON
Encoding
UTF-8
Language
DE & EN

Should you need information for all countries, it is advised to request the api without parameters. You'll get a reply with all countries at once with the same degree of details as calling them individually.

Calling the API

Endpoint:
https://www.reisewarnung.net/api

Optional parameter: country
https://www.reisewarnung.net/api?country=DE
ISO 2 Letter ciuntry code, eg. DE for Germany. See also: Wikipedia List of ISO 3166-1 alpha-2 codes

Description of data structure

Structure Type Field Description
api_status Array Common information about the reply.
request Array Feedback on what was requested
item String (2) This is the coutnry requested
reply VarChar Technical feedback on the api reply
code Integer Equals to http status codes. 200 means ok, 404 we haven't found any data.
status VarChar A description of the status code.
count Integer Numebr of results in [data]
data Array This is the actual data. When there is only one result (e.g. when called with country code), [data] is directly populated with the fields described below. When all countries are requested, [data] is an array of arrays with the fields below. The key for each country is the official ISO Alpha 2 country code.
code Array 2-Letter Codes for country and continent
country String (2) ISO Alpha 2 country code
continent String (2) 2 Letter continent code
situation VarChar Details about the current situation
sources Integer Number of found sources
rating Float Current danger rating between 0 (no danger) and 5 (high danger)
updated Timestamp Last update of danger rating
lang Array Language related information
de Array Germany (equivalent [en] for English)
country VarChar Name of country
continent VarChar Name of continent
continent_info VarChar Additional info about continental region
url_details VarChar Url of the single country details page
advice VarChar Short summary of the status in natural language
en Array ...
... ...

Sample reply for a single country

https://www.reisewarnung.net/api?country=DE

{

    "api_status": {
        "request": {
            "item": "de"
        },
        "reply": {
            "code": "200",
            "status": "ok",
            "note": "The api works, we could match requested country code.",
            "count": 1
        }
    },
    "data": {
        "code": {
            "country": "DE",
            "continent": "EU"
        },
        "situation": {
            "sources": 1,
            "rating": "2.0",
            "updated": "2016-06-15 07:18:21"
        },
        "lang": {
            "de": {
                "country": "Deutschland",
                "continent": "Europa",
                "continent_info": "Westeuropa",
                "url_details": "https://www.reisewarnung.net/deutschland",
                "advice": "Reisen nach Deutschland sind weitestgehend sicher."
            },
            "en": {
                "country": "Germany",
                "continent": "Europe",
                "continent_info": "Western Europe",
                "url_details": "https://www.reisewarnung.net/en/germany",
                "advice": "Travelling Germany is (relatively) safe."
            }
        }
    }

}
				

Usage

The api is free of charge, regardless of private or commercial use (except reselling). Should you use the data within a website or app, please use the url from the field "url_details" as source attribution (if countries are shown individually). You can pick the language that best suits you. Alternative, it is sufficient to just name Reisewarnung.net with a general link back to the project.

Since it's a private project, I can take no warranty for correctness or uptime of the api. If you have any questions, please check out the FAQ (see navigation) or contact me.