The API uses the JSON:API format and requires a token from the company for authentication. All requests are made using the POST method.

URL

POST https://api.riskline.com/ext/v1/trip-ready

Headers

When making a request, you need to specify the following headers:

Authorization: For authentication, include the token in the Authorization header as a Bearer token.
Content-Type: Specify the content type as application/vnd.api+json.

Request body

The request body must be in JSON format. Below is the structure you need to follow when making a request with some example values.

{
  "data": {
    "attributes": {
    "destination": "fr",
    "origin": "us",
    "language": "en",
    "dates": {
        "from": "2024-07-25",
        "to": "2024-07-30"
      }
    },
    "type": "trip-ready"
  }
}

destination: The ISO 3166 code representing the destination country or territory.
origin: The ISO 3166 code representing the origin country or territory.
from date: The date from which the information is requested. This must be set to the present or a future date.
to date: The date until which the information is requested. This must be set to a future date.
language: Language details will be provided by the company based on the access level.

Example

curl --location 'https://api.riskline.com/ext/v1/trip-ready' \
--header 'Content-Type: application/vnd.api+json' \
--header 'Authorization: Bearer 4gh7tyu2tq8n63axr1l9bv0okc2sew' \
--data '{
  "data": {
    "attributes": {
    "destination": "fr",
    "origin": "us",
    "language": "en",
    "dates": {
        "from": "2025-08-25",
        "to": "2025-08-30"
      }
    },
    "type": "trip-ready"
  }
}'

Example response

{
    "data": [
        {
            "id": "70",
            "type": "destinations",
            "attributes": {
                "iso_code": "FR",
                "name": "France"
            },
            "relationships": {
                "overall_risk_level": {
                    "data": {
                        "type": "risk_levels",
                        "id": "2"
                    }
                },
                "security_risk_level": {
                    "data": {
                        "type": "risk_levels",
                        "id": "2"
                    }
                },
                "health_risk_level": {
                    "data": {
                        "type": "risk_levels",
                        "id": "1"
                    }
                }
            }
        },
        {
            "id": "35405",
            "type": "advisories",
            "attributes": {
                "title": "Increased risk of terrorism, travel disruption and unrest in Western countries and their diplomatic representations abroad",
                "text": "<p>Exercise caution for travel across <strong>Western countries</strong>, including <strong>France</strong>, <strong>Belgium</strong>, the <strong>United Kingdom (UK)</strong>, <strong>Germany</strong>, the <strong>Netherlands</strong>, <strong>Sweden</strong>, <strong>Austria</strong>, <strong>Denmark</strong>, <strong>Hungary</strong>, <strong>Italy</strong>, <strong>Spain</strong>, the <strong>Czech Republic</strong>, <strong>Slovenia</strong>, <strong>Serbia</strong> and the <strong>United States (US)</strong>, particularly in densely populated urban centres, as well as in the vicinity of diplomatic representations, amid heightened security and related disruptions due to an increased risk of terror attacks, hate crimes and possible unrest.</p>"
            },
            "relationships": {
                "risk_level": {
                    "data": {
                        "type": "risk_levels",
                        "id": "3"
                    }
                }
            }
        },
        {
            "id": "35412",
            "type": "advisories",
            "attributes": {
                "title": "Schengen Internal Border Controls",
                "text": "<p>Travellers should anticipate possible disruptions or delays to travel at affected borders, due to the reintroduction of border controls at select crossings within the Schengen Area and ensure all identification and travel documents are valid and compliant with the latest entry requirements.</p>"
            },
            "relationships": {
                "risk_level": {
                    "data": {
                        "type": "risk_levels",
                        "id": "2"
                    }
                }
            }
        },
        {
            "id": "2665",
            "type": "emergency_number",
            "attributes": {
                "number": "112",
                "service_category": "Emergency",
                "additional_info": "PanEuropean emergency number"
            }
        },
        {
            "id": "2666",
            "type": "emergency_number",
            "attributes": {
                "number": "114",
                "service_category": "Other",
                "additional_info": "Emergency number for hearing impaired people (SMS & fax only)"
            }
        },
        {
            "id": "2667",
            "type": "emergency_number",
            "attributes": {
                "number": "115",
                "service_category": "Other",
                "additional_info": "Emergency shelter for homeless people"
            }
        },
        {
            "id": "2668",
            "type": "emergency_number",
            "attributes": {
                "number": "116000",
                "service_category": "Other",
                "additional_info": "Missing children"
            }
        },
        {
            "id": "2669",
            "type": "emergency_number",
            "attributes": {
                "number": "119",
                "service_category": "Other",
                "additional_info": "Children at risk"
            }
        },
        {
            "id": "2670",
            "type": "emergency_number",
            "attributes": {
                "number": "15",
                "service_category": "Medical",
                "additional_info": "Medical emergency Ambulance"
            }
        },
        {
            "id": "2671",
            "type": "emergency_number",
            "attributes": {
                "number": "17",
                "service_category": "Police",
                "additional_info": null
            }
        },
        {
            "id": "2672",
            "type": "emergency_number",
            "attributes": {
                "number": "18",
                "service_category": "Fire",
                "additional_info": null
            }
        },
        {
            "id": "1057",
            "type": "summaries",
            "attributes": {
                "title": "Crime",
                "text": "<p>France has relatively high crime rates compared with many European countries, and these rates have risen in recent years. Crime is most serious in the major urban centres, particularly in <strong>Paris</strong>, <strong>Marseille</strong>, <strong>Lyon</strong>, <strong>Lille</strong>, <strong>Bordeaux</strong> and <strong>Nantes</strong>. Petty theft is more common than serious crimes, such as carjacking and assault. The police and emergency services are very reliable.</p>",
                "weight": 5,
                "last_update": "2025-01-07"
            },
            "relationships": {
                "risk_level": {
                    "data": {
                        "type": "risk_levels",
                        "id": "2"
                    }
                }
            }
        },
        {
            "id": "1615",
            "type": "summaries",
            "attributes": {
                "title": "Natural",
                "text": "<p>The country is vulnerable to floods, avalanches and blizzards, which could disrupt overland, maritime and air travel, particularly in winter. Heat waves and wildfires can take place during the summer season. Damages and disruptions are, however, limited due to the country's excellent infrastructure and emergency response services. </p>",
                "weight": 7,
                "last_update": "2025-01-07"
            },
            "relationships": {
                "risk_level": {
                    "data": {
                        "type": "risk_levels",
                        "id": "2"
                    }
                }
            }
        },
        {
            "id": "1844",
            "type": "summaries",
            "attributes": {
                "title": "Politics",
                "text": "<p>France is one of Europe’s biggest and most stable nations. It is a semi-presidential democracy with a long history of peaceful transfers of power, entrenched respect for civil rights and a strong economy. As a founding member of the European Union (EU), France exerts considerable influence on global politics. However, political polarisation has intensified with the rise of right-wing populism. Following the 2024 legislative elections, the National Assembly is divided into three blocs, none with an absolute majority. After the Barnier government was toppled, François Bayrou was appointed prime minister in December 2024, tasked with passing a budget amid the risk of a new no-confidence motion.</p>",
                "weight": 1,
                "last_update": "2025-01-07"
            },
            "relationships": {
                "risk_level": {
                    "data": {
                        "type": "risk_levels",
                        "id": "2"
                    }
                }
            }
        },
        {
            "id": "2073",
            "type": "summaries",
            "attributes": {
                "title": "Conflict",
                "text": "<p>France is not part of a direct conflict with other states. There are calls for independence in some of the overseas regions it continues to control, such as in <strong>New</strong> <strong>Caledonia</strong> and <strong>Corsica</strong>, but these calls for independence are unlikely to escalate into open conflict. France is a permanent member of the United Nations Security Council (UNSC) and a member of the North Atlantic Treaty Organisation (NATO). It contributes to the US-led coalition against the Islamic State (IS).</p>",
                "weight": 2,
                "last_update": "2025-01-07"
            },
            "relationships": {
                "risk_level": {
                    "data": {
                        "type": "risk_levels",
                        "id": "1"
                    }
                }
            }
        },
        {
            "id": "2299",
            "type": "summaries",
            "attributes": {
                "title": "Terrorism",
                "text": "<p>Due to France's active participation in military campaigns in Africa and the Middle East, the country is a target for Islamist attacks. It also has a large population of underprivileged Muslim immigrants, which has facilitated recruitment efforts for such groups, allowing them to conduct large-scale attacks. French security and intelligence services are highly trained, experienced and equipped to effectively prevent and respond to attacks.</p>",
                "weight": 3,
                "last_update": "2025-01-07"
            },
            "relationships": {
                "risk_level": {
                    "data": {
                        "type": "risk_levels",
                        "id": "2"
                    }
                }
            }
        },
        {
            "id": "2529",
            "type": "summaries",
            "attributes": {
                "title": "Unrest",
                "text": "<p>France experiences large-scale protests and strikes regularly across the country, particularly in <strong>Paris</strong>, where Yellow Vest anti-government demonstrators, anti-racism activists and labour unions hold weekly rallies. Police forces will often respond with tear gas and baton charges to disperse protests.</p>",
                "weight": 4,
                "last_update": "2025-01-07"
            },
            "relationships": {
                "risk_level": {
                    "data": {
                        "type": "risk_levels",
                        "id": "3"
                    }
                }
            }
        },
        {
            "id": "5428",
            "type": "summaries",
            "attributes": {
                "title": "Travel",
                "text": "<p>The country has an excellent public transport network that includes boats, ferries, trains, subways, taxis and buses, which are reliable and safe. Air travel is widely available and safe. Vehicular travel is also recommended, as road conditions are excellent nationwide.</p>",
                "weight": 8,
                "last_update": "2024-12-10"
            },
            "relationships": {
                "risk_level": {
                    "data": {
                        "type": "risk_levels",
                        "id": "1"
                    }
                }
            }
        },
        {
            "id": "9019",
            "type": "summaries",
            "attributes": {
                "title": "Health",
                "text": "<p>The country has some of the best health facilities in the world, and hospitals across the country are highly equipped and staffed by medical professionals who are almost always multilingual. High-quality prescription drugs are widely available, and infectious diseases present little to no risk to travellers.</p>",
                "weight": 14,
                "last_update": "2024-12-10"
            },
            "relationships": {
                "risk_level": {
                    "data": {
                        "type": "risk_levels",
                        "id": "1"
                    }
                }
            }
        },
        {
            "id": "3189",
            "type": "female_travellers",
            "attributes": {
                "title": "Female Travellers"
            },
            "relationships": {
                "assessment": {
                    "data": {
                        "type": "assessments",
                        "id": "51"
                    }
                },
                "elements": {
                    "data": [
                        {
                            "type": "female_traveller_elements",
                            "id": "36805"
                        },
                        {
                            "type": "female_traveller_elements",
                            "id": "37034"
                        },
                        {
                            "type": "female_traveller_elements",
                            "id": "37263"
                        }
                    ]
                }
            }
        },
        {
            "id": "35590",
            "type": "lgbtq_travellers",
            "attributes": {
                "title": "LGBTQ Travellers",
                "text": "<p>Homosexuality is legal in France. Change of legal gender is allowed by the law. However, proof of having undergone gender-affirming surgery and care might be required in order to change gender on identification documents. Same-sex marriage, as well as civil unions, are legal. LGBTQ persons are widely accepted. Officials recognize passports where gender is indicated as \"neutral\".</p><p>In France, protection laws for the LGBTQ community are overall good and have progressed in recent years. In 2022, conversion therapies were banned nationwide. Authorities allow the change of gender markers on official documents such as birth and marriage certificates, IDs' and passports.</p><p>LGBTQ travellers are unlikely to face any difficulties or legal issues for travel.</p><p>LGBTQ-friendly activities and venues are extensively available in <strong>Paris</strong>' <strong>Marais district</strong>. Other LGBTQ-friendly cities are <strong>Nice</strong>, <strong>Marseille</strong>, <strong>Lyon</strong>, among others. Social conservatism may still be prevalent in some parts of the country, especially in rural areas and small towns.</p><p>A list of helpful NGOs and human-rights organisations helping LGBTQ individuals in France are available <a href=\"https://www.centrelgbtparis.org/les-associations-adherentes\" target=\"_blank\" rel=\"noopener\">here</a> and <a href=\"https://proud-and-gay.fr/blogs/proud-gay-le-blog/les-associations-lgbt-essentielles\" target=\"_blank\" rel=\"noopener\">here</a>.</p>"
            },
            "relationships": {
                "assessment": {
                    "data": {
                        "type": "assessments",
                        "id": "48"
                    }
                }
            }
        },
        {
            "id": "70",
            "type": "visa_checks",
            "attributes": {
                "is_required": "Maybe, depending on the type of trip"
            },
            "relationships": {
                "rules": {
                    "data": [
                        {
                            "type": "visa_rules",
                            "id": "41"
                        },
                        {
                            "type": "visa_rules",
                            "id": "328"
                        }
                    ]
                }
            }
        },
        {
            "id": "9167",
            "type": "vaccinations",
            "attributes": {
                "name": "Yellow Fever entry requirement (Source: USA CDC)",
                "text": "<p>None</p>",
                "kind": "yellow-fever"
            }
        },
        {
            "id": "336218",
            "type": "alerts",
            "attributes": {
                "title": "Authorities extend visa-free policy for nationals of France, 11 other countries until 31 December 2025 - Update",
                "text": "Authorities extended the policy to allow visa-free entry for holders of French, German, Italian, Dutch, Spanish, Malaysian, Swiss, Irish, Hungarian, Austrian, Belgian and Luxembourgish ordinary passports until 31 December 2025 in order to boost inbound tourism. The period of stay for visa-free entry is 15 days.",
                "advice": "Consult Chinese consular authorities for the viability of entry."
            },
            "relationships": {
                "risk_level": {
                    "data": {
                        "type": "risk_levels",
                        "id": "1"
                    }
                }
            }
        },
        {
            "id": "357705",
            "type": "alerts",
            "attributes": {
                "title": "Authorities to extend visa-free entry scheme’s stay validity from 30 November-31 December 2025",
                "text": "Chinese authorities announced the extension of a visa-free entry scheme’s stay validity from 15 to 30 days for nationals of countries part of a trial policy, effective from 30 November until 31 December 2025. The scheme will apply to travel for business, tourism, transit, exchanges and family visits.",
                "advice": "Consult Chinese consular authorities for the viability of entry prior to departure."
            },
            "relationships": {
                "risk_level": {
                    "data": {
                        "type": "risk_levels",
                        "id": "1"
                    }
                }
            }
        },
        {
            "id": "360163",
            "type": "alerts",
            "attributes": {
                "title": "Belarusian officials extend visa-free scheme for nationals of European countries through 31 December 2025 - Update",
                "text": "Belarusian officials announced the extension of the visa-free scheme for nationals of European countries entering through all road and railway checkpoints for up to 30 days through 31 December 2025. Nationals of Poland, Latvia and Lithuania will remain eligible for visa-free entry for up to 90 days.",
                "advice": "Consult Belarusian consular authorities for the viability of entry prior to departure."
            },
            "relationships": {
                "risk_level": {
                    "data": {
                        "type": "risk_levels",
                        "id": "1"
                    }
                }
            }
        }
    ],
    "included": [
        {
            "id": "2",
            "type": "risk_levels",
            "attributes": {
                "name": "Moderate"
            }
        },
        {
            "id": "1",
            "type": "risk_levels",
            "attributes": {
                "name": "Low"
            }
        },
        {
            "id": "3",
            "type": "risk_levels",
            "attributes": {
                "name": "Medium"
            }
        },
        {
            "id": "51",
            "type": "assessments",
            "attributes": {
                "value": "1",
                "name": "Normal Concern",
                "description": "<p>Female travellers are unlikely to face difficulties. Local customs and cultural attitudes are open and progressive.</p>",
                "advice": "<p><strong><em>Female travellers should exercise normal safety precautions.</em></strong></p>"
            }
        },
        {
            "id": "36805",
            "type": "female_traveller_elements",
            "attributes": {
                "title": "Laws and Customs",
                "text": "<p>There are no local customs or laws that a female traveller should take into consideration in France. Familiarise yourself with your destination prior to travel, and be respectful and mindful of any possible cultural sensitivities, which may include dress, behaviour and topics of discussions.</p>",
                "weight": 18
            },
            "relationships": {
                "assessment": {
                    "data": {
                        "type": "assessments",
                        "id": "4"
                    }
                }
            }
        },
        {
            "id": "37034",
            "type": "female_traveller_elements",
            "attributes": {
                "title": "Safety",
                "text": "<p>There are minimal safety concerns female travellers should take into consideration in France. Sexual assault and rape do occur; however, visitors to the country are not likely to face additional risk as most perpetrators of assault are known to their victim. While isolated incidents of street harassment and assault are reported in large cities, it is not a widespread concern. Police and emergency services maintain a high degree of professionalism, and female travellers will not encounter any problems dealing with first responders or reporting crimes to local authorities. Exercise personal safety awareness if walking alone at night. Stick to main, well-lit streets and avoid walking through desolate areas or unfamiliar neighbourhoods. Refrain from wearing headphones while walking in the evening.</p>",
                "weight": 19
            },
            "relationships": {
                "assessment": {
                    "data": {
                        "type": "assessments",
                        "id": "4"
                    }
                }
            }
        },
        {
            "id": "37263",
            "type": "female_traveller_elements",
            "attributes": {
                "title": "Health and Wellness",
                "text": "<p>Women have access to a full range of gynaecological and reproductive health services, medicines and products in France. These include specialised clinics, abortion services, OTC emergency contraceptives, prescription contraceptives and a full variety of feminine hygiene products. Travellers can easily access OTC emergency contraceptives, prescription contraceptives and a full variety of feminine hygiene products. Abortions are allowed within the first 12 weeks of pregnancy. Abortions are performed during later stages under special circumstances with the approval of a commission.</p>",
                "weight": 20
            },
            "relationships": {
                "assessment": {
                    "data": {
                        "type": "assessments",
                        "id": "4"
                    }
                }
            }
        },
        {
            "id": "48",
            "type": "assessments",
            "attributes": {
                "value": "1",
                "name": "Normal Concern",
                "description": "<p>LGBTQ travellers are unlikely to face difficulties. Local attitudes towards the LGBTQ community are overall open and progressive.</p>",
                "advice": "<p><strong><em>LGBTQ travellers should exercise normal safety precautions.</em></strong></p>"
            }
        },
        {
            "id": "41",
            "type": "visa_rules",
            "attributes": {
                "name": "ETIAS",
                "text": "<p>The ETIAS travel authorisation will be a mandatory pre-condition for entry to the Schengen States.</p> <p>It will be checked together with the travel documents by the border guards when crossing the EU border and is valid for stays of up to 90 days in a 180-day period.</p> <p>Applicants will be able to apply via an official website and/or app for mobile devices prior to the effective start of ETIAS.</p> <p>The launch of the European Travel Information and Authorisation System (ETIAS) is postponed until May 2025, with the possibility of further delays.</p>"
            }
        },
        {
            "id": "328",
            "type": "visa_rules",
            "attributes": {
                "name": "Visa-free travel within the Schengen area",
                "text": "<p>Citizens of any country that is part of the Schengen agreement can freely enter and reside in any Schengen country without a visa. Some foreign nationals from non-Schengen countries are also allowed entry without a visa, including citizens of the United Kingdom (UK), United States of America (USA), and Canada among others.</p>"
            }
        },
        {
            "id": "4",
            "type": "assessments",
            "attributes": {
                "value": "1",
                "name": "Normal Concern",
                "description": null,
                "advice": null
            }
        }
    ],
    "jsonapi": {
        "version": "1.0"
    }
}