Procedures

Notify travellers about health, medical, visa and safety requirements.

Introduction

Procedures are used to describe visa requirements, medical, health, safety or other entry requirements that are imposed by a government, an airline or an airport.

Retrieving Procedures

📘

View the API Reference

Check procedures for a Region (E.g. Canada (CAN)).

{
    "meta": {
        "copyright": "Sherpa",
        "version": "2.8.3"
    },
    "data": [
        {
            "id": "02efa579-ab8e-4ac0-bd4a-a1013480e00c",
            "type": "PROCEDURE",
            "attributes": {
                "country": "CAN",
                "title": "Electronic Authorization or Visa",
                "description": "Business or Tourism visitors arriving by air who held a Canadian visitor visa in the past 10 years or currently hold a valid US nonimmigrant visa are eligible for an electronic travel authorization.\n\nOtherwise, a paper or embassy visa is the only type of visa available for visitors. Typically the visa is a stamp or sticker added to your passport. You must submit your application through the consulate or local visa center.\n\nVisit the government website for details.",
                "more": [],
                "enforcement": "MANDATORY",
                "documentType": [
                    "ETA"
                ],
                "documentLinks": [],
                "tags": [
                    "international",
                    "land",
                    "air",
                    "sea",
                    "tourism",
                    "business"
                ],
                "source": {
                    "sourceType": "GOVERNMENT",
                    "title": "Government of Canada",
                    "url": "https://www.canada.ca/en/immigration-refugees-citizenship/services/visit-canada/entry-requirements-country.html"
                },
                "lastUpdatedAt": "2021-10-12T14:42:00.000Z",
                "createdAt": "2021-07-21T17:10:00.000Z",
                "startDate": null,
                "endDate": null,
                "travelPurpose": [
                    "TOURISM",
                    "BUSINESS"
                ],
                "included": [
                    {
                        "code": "BRA",
                        "text": "Brazil",
                        "type": "NATIONALITY"
                    },
                    {
                        "code": "BGR",
                        "text": "Bulgaria",
                        "type": "NATIONALITY"
                    },
                    {
                        "code": "ROU",
                        "text": "Romania",
                        "type": "NATIONALITY"
                    }
                ],
                "category": "DOC_REQUIRED",
                "subCategory": "BEFORE_ARRIVAL"
            },
            "relationships": {
                "country": {
                    "data": {
                        "id": "CAN",
                        "type": "COUNTRY"
                    }
                }
            }
        },
                {
            "id": "113de2c3-7fad-41be-b17e-0b8d0932bbdf",
            "type": "PROCEDURE",
            "attributes": {
                "country": "CAN",
                "title": "Travelers departing from Canadian airports require proof of vaccination",
                "description": "Travelers departing from Canadian airports, rail, and passengers vessels on voyages of 24 hours or more need to be fully vaccinated in order to board. This requirement applies to international and domestic departures.\n\nFully vaccinated travelers must have received a full course of vaccination with an accepted vaccine. The accepted 2 dose vaccines are:\n-AstraZeneca/COVISHIELD (ChAdOx1-S, Vaxzevria, AZD1222)\n-Bharat Biotech (Covaxin, BBV152 A, B, C)\n-Moderna (mRNA-1273)\n-Pfizer-BioNTech (Comirnaty, tozinameran, BNT162b2)\n-Sinopharm BIBP (BBIBP-CorV)\n-Sinovac (CoronaVac, PiCoVacc)\n\nThe accepted 1 dose vaccine is:\n-Janssen/Johnson & Johnson\n\nTravelers that have received a combination of 2 accepted vaccines are considered fully vaccinated. Travelers must have received their last dose at least 15 days before arrival.\n\nTravelers who fail to comply, refuse, or provide untruthful information on this measure, may be subject to a penalty or a fine.",
                "more": [
                    "This requirement does not apply to:\n-Travelers under the age of 12 years plus 4 months;\n-Travelers crossing the Canada-US land border. \n\nFor exemptions for travelers in the process of being vaccinated, travelers from remote communities, and more, please check the source."
                ],
                "enforcement": "MANDATORY",
                "documentType": [
                    "COVID_19_VACCINATION"
                ],
                "documentLinks": [],
                "tags": [
                    "international",
                    "domestic",
                    "fully_vaccinated",
                    "air",
                    "land",
                    "sea"
                ],
                "source": {
                    "sourceType": "GOVERNMENT",
                    "title": "Government of Canada",
                    "url": "https://www.canada.ca/en/transport-canada/news/2021/10/mandatory-covid-19-vaccination-requirements-for-federally-regulated-transportation-employees-and-travellers.html"
                },
                "lastUpdatedAt": "2022-02-10T01:34:00.000Z",
                "createdAt": "2021-11-21T21:39:00.000Z",
                "startDate": "2021-11-30T00:00:00.000Z",
                "endDate": null,
                "category": "DOC_REQUIRED",
                "subCategory": "BEFORE_DEPARTURE"
            },
            "relationships": {
                "country": {
                    "data": {
                        "id": "CAN",
                        "type": "COUNTRY"
                    }
                }
            }
        },
curl --location -g--request 
GET 'https://requirements-api.sandbox.joinsherpa.com/v2/procedures?key=<API_KEY>&filter[country]=CAN'

Getting Visa specific information from /Procedures endpoint

The visa requirements as part of the v2/procedures resource endpoint presents a traveller with visa-specific information for a destination as it relates to different nationalities.

Retrieving Procedures

Check Visa procedures for a country (E.g. Canada (CAN)).

curl --request GET \
  --url 'https://requirements-api.sandbox.joinsherpa.com/v2/procedures?key={{apiKey}}&filter[country]=CAN&filter[nationalities]=USA&filter[documentType]=VISA,E_VISA,ETA,EMBASSY_VISA&filter[category]=DOC_REQUIRED
{
    "meta": {
        "copyright": "Sherpa",
        "version": "2.8.4"
    },
    "data": [
        {
            "id": "dbd5b096-9997-4d3f-a8b3-9ff07e65757b",
            "type": "PROCEDURE",
            "attributes": {
                "country": "CAN",
                "title": "No visa required",
                "description": "Visitors traveling for Business or Tourism do not require a visa.\nTo check permitted length of stay and other entry requirements, visit the government site.",
                "more": [],
                "enforcement": "NOT_REQUIRED",
                "documentType": [
                    "VISA"
                ],
                "documentLinks": [],
                "tags": [
                    "international",
                    "land",
                    "air",
                    "sea",
                    "tourism",
                    "business",
                    "transit"
                ],
                "source": {
                    "sourceType": "GOVERNMENT",
                    "title": "Government of Canada",
                    "url": "https://www.canada.ca/en/immigration-refugees-citizenship/services/visit-canada/entry-requirements-country.html"
                },
                "lastUpdatedAt": "2021-09-08T15:12:00.000Z",
                "createdAt": "2021-04-27T03:44:00.000Z",
                "startDate": null,
                "endDate": null,
                "lengthOfStay": [
                    {
                        "type": "DAYS",
                        "value": 180,
                        "text": "180 days"
                    }
                ],
                "travelPurpose": [
                    "TOURISM",
                    "BUSINESS",
                    "TRANSIT"
                ],
                "included": [
                    {
                        "code": "USA",
                        "text": "United States",
                        "type": "NATIONALITY"
                    },
                    {
                        "code": "GUM",
                        "text": "Guam",
                        "type": "NATIONALITY"
                    },
                    {
                        "code": "PRI",
                        "text": "Puerto Rico",
                        "type": "NATIONALITY"
                    },
                    {
                        "code": "ASM",
                        "text": "American Samoa",
                        "type": "NATIONALITY"
                    },
                    {
                        "code": "VIR",
                        "text": "U.S. Virgin Islands",
                        "type": "NATIONALITY"
                    }
                ],
                "category": "DOC_REQUIRED",
                "subCategory": "BEFORE_ARRIVAL"
            },
            "relationships": {
                "country": {
                    "data": {
                        "id": "CAN",
                        "type": "COUNTRY"
                    }
                }
            }
        }
    ]
}

Visa Procedure Model

AttributeTypeDescription
idstringA unique identifier for the Visa procedure.
typestringIndicates the type of data being presented (will show PROCEDURE)
countrystringA 3-word ISO code for the issuing authority / country.
titlestringA title for document type (can be Visitor Visa, Tourist Visa, Business Visa etc)
enforcementstringThe level of enforcement (can be MANDATORY or NOT_REQUIRED)
documentTypeobjectThe type of visa required for the specific trip (can be VISA or eVISA, ETA, EMBASSY_VISA)
tagsarrayIndicates the ports of entry on which the specific visa applies (can be international, land, air, sea, tourism, business or transit )
sourcestringThis points to the source, url and link of the information (usually a government site, airline or tourism board)
sourceType: Source of the information
title: Title of the source
url : Source http address
lastUpdatedAtstringLast date sherpa updated its database with information on this requirement.
createdAtstringDate when the requirement was created in Sherpa's repository.
startDatestringDate when the requirement became active. This is usually empty since most visa requirements have been in place.
endDatestringDate when the requirement is expected to end. This is also always empty since visa requirements unlike covid restrictions are not expected to end soon.
lengthOfStaystringThe number of days a traveller is allowed to stay in the destination country with a visa or without, if it is not enforced or required.
travelPurposestringThe purpose for which the visa requirement is issued. This can be Tourism, Business or Transit .
included arrayA list of countries affected by the specific visa requirement.

Available Filters

Filter NameData Filtered
Filter[country]Visa procedures can be filtered based on country. This wIll take ISO-3 value of a country (eg: GHA, CAN) as parameter.
Filter[nationalities]Visa procedures can be filtered based on nationality, indicating the nationality of the traveller. This will take ISO-3 value of a country (eg: GHA, CAN) as parameter.
Filter[documentType]Visa procedures can be filtered based on document type. Any or all of the following can be passed as parameters: VISA, E_VISA, ETA, EMBASSY_VISA
Filter[category]Visa procedures can be filtered based on category. This will take some or all of the following QUARANTINE, HEALTH_MEASURES, PPE, DOC_REQUIRED, COVID_19_TEST, NO_QUARANTINE, NO_COVID_19_TEST, HEALTH_ASSESSMENT, SANITIZATION, RE_ENTRY_PERMIT, DEPOSIT_REQUIRED, HEALTH_INSURANCE, TRAVEL_INSURANCE values as parameters.

Examples

Below is a sample search for a Canadian Visa Requirement for a United States national

{
    "meta": {
        "copyright": "Sherpa",
        "version": "2.8.4"
    },
    "data": [
        {
            "id": "dbd5b096-9997-4d3f-a8b3-9ff07e65757b",
            "type": "PROCEDURE",
            "attributes": {
                "country": "CAN",
                "title": "No visa required",
                "description": "Visitors traveling for Business or Tourism do not require a visa.\nTo check permitted length of stay and other entry requirements, visit the government site.",
                "more": [],
                "enforcement": "NOT_REQUIRED",
                "documentType": [
                    "VISA"
                ],
                "documentLinks": [],
                "tags": [
                    "international",
                    "land",
                    "air",
                    "sea",
                    "tourism",
                    "business",
                    "transit"
                ],
                "source": {
                    "sourceType": "GOVERNMENT",
                    "title": "Government of Canada",
                    "url": "https://www.canada.ca/en/immigration-refugees-citizenship/services/visit-canada/entry-requirements-country.html"
                },
                "lastUpdatedAt": "2021-09-08T15:12:00.000Z",
                "createdAt": "2021-04-27T03:44:00.000Z",
                "startDate": null,
                "endDate": null,
                "lengthOfStay": [
                    {
                        "type": "DAYS",
                        "value": 180,
                        "text": "180 days"
                    }
                ],
                "travelPurpose": [
                    "TOURISM",
                    "BUSINESS",
                    "TRANSIT"
                ],
                "included": [
                    {
                        "code": "USA",
                        "text": "United States",
                        "type": "NATIONALITY"
                    },
                    {
                        "code": "GUM",
                        "text": "Guam",
                        "type": "NATIONALITY"
                    },
                    {
                        "code": "PRI",
                        "text": "Puerto Rico",
                        "type": "NATIONALITY"
                    },
                    {
                        "code": "ASM",
                        "text": "American Samoa",
                        "type": "NATIONALITY"
                    },
                    {
                        "code": "VIR",
                        "text": "U.S. Virgin Islands",
                        "type": "NATIONALITY"
                    }
                ],
                "category": "DOC_REQUIRED",
                "subCategory": "BEFORE_ARRIVAL"
            },
            "relationships": {
                "country": {
                    "data": {
                        "id": "CAN",
                        "type": "COUNTRY"
                    }
                }
            }
        }
    ]
}