If you are only interested in VISA requirements you could use the procedures endpoint to retrieve and display this information.
Let’s see how to query this endpoint using a trip scenario.
Scenario: A UK traveller is going from London, Heathrow to JFK on August 30, 2022, for tourism purposes.
If we take a look at the filters for this endpoint, we can determine the ones we will need for our scenario: country, category, nationalities, documentType.
Using these filters and values we can build the following request URL:
In the API response (see attachment), you will notice two procedures are returned with the following IDs:
5683d46a-9338-41b1-a1f5-897a598e9a57The first procedure 33a0e979-29eb-430d-a636-eb075baff42f is for an Electronic Travel Authorization (ESTA), however, this only applies to transits and does not fit our scenario.
We can filter transits out by looking at
The second procedure 5683d46a-9338-41b1-a1f5-897a598e9a57 is also for an Electronic Travel Authorization (ESTA), however, this time the
So, we can use the
travelPurpose property to filter trips that are for
TOURISM only and display this procedure.
What about the traveller’s trip dates and upcoming procedures?
Our API will response will only include active and upcoming procedures. The
data.attributes.startDate can be used to differentiate between active and upcoming procedures that may come into effect during a traveller’s trip.
Download API Response
You can download the sample API response file here.
Updated 3 months ago