To use the API, you need to make a POST request for retrieving the data.

curl --location 'https://api.riskline.com/ext/v1/travel-search' \
--header 'Authorization: Bearer 123456789' \
--header 'Content-Type: application/json' \
--data '{
    "nationality": "gb",
    "origin": "fr",
    "destination": "de",
    "dates": {
        "from": "2023-07-15",
        "to": "2023-07-25"
    },
    language: "fr"
}

Authorization

The authorization token will be provided by Riskline.

Body

All fields, except nationality, are mandatory fields. If the traveller does not indicate their nationality, it will default to the selected origin country.

The origin and destination follow the below specifications:

  • Cities: major urban areas typically indicated by the IATA code. Many, but not all, cities are included in Riskline's database.
  • Regions: administrative level 1 geopolitical areas indicated by ISO 3166-2 codes.
  • Countries and territories: administrative level 0 geopolitical areas indicated by ISO 3166 codes.

The cities, regions and countries mentioned can be found in the Collections section.

Date format for both from and to is YYYY-MM-DD and they require to be set in the future.