Restrictions

Notify travellers about travel restrictions.

Introduction

Restrictions are used to describe policies imposed by a country, region, airline or airport that prevent certain people from travelling.

For example There is a temporary ban of entry to all non-EU/EEA citizens

Retrieving Restrictions

📘

View the API Reference

Please note below is an illustrative example for all restrictions for CAN. Below is, for example purposes only and is not an exhaustive list of all attributes.

{
    "meta": {
        "copyright": "Sherpa",
        "version": "2.8.3"
    },
    "data": [
        {
            "id": "373fb98c-41f0-4be7-9f76-b5a67fbb93a6",
            "type": "RESTRICTION",
            "attributes": {
                "country": "CAN",
                "title": "Transit is allowed with restrictions",
                "description": "Travelers are allowed to transit through Canada to third countries as long as they do not leave the international airport area. \n\nDomestic transfers are not permitted for Canadian citizens, permanent residents, resettling refugees, and persons registered under the Indian Act who don't qualify as fully vaccinated.",
                "more": [
                    "Overnight connections are not possible at:\n-Montréal-Trudeau (YUL);\n-Calgary International (YYC);\n-Vancouver International (YVR);\n-Toronto Pearson (YYZ)."
                ],
                "severity": 1,
                "documentLinks": [],
                "tags": [
                    "international",
                    "air",
                    "transit"
                ],
                "source": {
                    "sourceType": "GOVERNMENT",
                    "title": "Canadian Government",
                    "url": "https://www.canada.ca/en/immigration-refugees-citizenship/services/coronavirus-covid19/travel-restrictions-exemptions.html#exemptions"
                },
                "lastUpdatedAt": "2022-02-10T01:41:00Z",
                "createdAt": "2021-11-21T21:44:00Z",
                "startDate": "2021-11-30T00:00:00Z",
                "endDate": null,
                "category": "RESTRICTED_ENTRY",
                "subCategory": "TRANSIT"
            },
                      "relationships": {
                "country": {
                    "data": {
                        "id": "CAN",
                        "type": "COUNTRY"
                    }
                }
            }
        },
        {
        {
            "id": "425f49db-5f8b-47f3-b289-60cf6f6f6286",
            "type": "RESTRICTION",
            "attributes": {
                "country": "CAN",
                "title": "Entry restricted for unvaccinated travelers",
                "description": "Most unvaccinated international travelers are not allowed to enter Canada. ",
                "more": [
                    "Entry restrictions do not apply to:\n-Canadian citizens;\n-Permanent residents;\n-Some categories of employer-specific work permit holders;\n-Extended family members include those in a long-term, exclusive dating relationship and their dependent children, plus adult children, grandchildren, siblings, parents, and grandparents under certain conditions;\n-Foreign nationals for compassionate reasons in specific and limited situations, including to say goodbye to a loved one, to provide care for a loved one, or to attend a funeral;\n-Foreign nationals arriving directly from the US for a non-discretionary purpose;\n-Persons registered under the Indian Act;\n-International students approved by a provincial or territorial government as having a COVID-19 readiness plan will be allowed to enter Canada;\n-Fully vaccinated travelers who have completed the full course of vaccination with a Government of Canada-accepted vaccine (pending confirmation).\n\nBefore boarding an aircraft for a flight between two points in Canada or a flight to Canada departing from any other country, every traveler must confirm to the private operator or air carrier operating the flight that they understand that they may be subject to a measure to prevent the spread of COVID-19 taken by the provincial or territorial government with jurisdiction where the destination aerodrome for that flight is located or by the federal government.\n\nFor more information and to see more exemptions, please check the source."
                ],
                "severity": 5,
                "documentLinks": [],
                "tags": [
                    "international",
                    "not_vaccinated",
                    "air"
                ],
                "source": {
                    "sourceType": "GOVERNMENT",
                    "title": "Canadian Government",
                    "url": "https://tc.canada.ca/en/initiatives/covid-19-measures-updates-guidance-issued-transport-canada"
                },
                "lastUpdatedAt": "2022-02-10T01:29:00Z",
                "createdAt": "2021-09-22T14:30:00Z",
                "startDate": "2021-09-27T00:00:00Z",
                "endDate": null,
                "included": [
  											...
                    }
                ],
                "category": "NO_ENTRY",
                "subCategory": "ENTRY"
            },
            "relationships": {
                "country": {
                    "data": {
                        "id": "CAN",
                        "type": "COUNTRY"
                    }
                }
            }
        },
curl --location -g --request 
GET 'https://requirements-api.sandbox.joinsherpa.com/v2/restrictions?key=<API_KEY>&filter[country]=CAN'

Directionality (preview)

📘

Preview attributes may change

This attribute is a preview and can be utilized to indicate the direction of a restriction, compared to the previous statement of that particular restriction.
Preview attributes may change or might be marked as deprecated in future updates before being removed.

ValueDescription
LESSThe restriction has become less stringent.
MOREThe restriction has become more stringent
NO_CHANGEThe level of restriction has not changed.

Additional Documents

AttributeDescription
documentLinksA list of URLs that link to a document or form that relates to this restriction.

Accuracy

Each Restriction object in the response includes details about the source of information, when it was last checked and updated.

View a sample request and response that checks restrictions for a Country (E.g. Canada (CAN)).

👍

Tip

Using the sourceType and stillCurrentAt properties, you can limit the restrictions to Government sources that are accurate as of this week.

📘

View the API Reference