Tripsguard API v1 Manual

About

Use the Tripsguard API v1 to get up-to-date information about travel and COVID-related restrictions at over 200 worldwide destinations, for displaying in your own website or app.

The current list of monitored destinations includes well over 200 countries, federal states and territories, and data is updated daily.

Version 2 of this API provide even more fine-grained detail, allowing you to tailor user-specific guidance for each destination, depending on the traveler's origin and nationality. If you're interested in version 2 of the API, please contact support@tripsguard.com.

API Access

API Endpoint

The API is accessible at: https://api.tripsguard.com/

Authentication

The API uses HTTP Basic authentication, which is a simple and standard authentication scheme built into the HTTP protocol. The client sends HTTP requests an Authorization header that contains the word Basic followed by a space and a base64-encoded string <username>:<password>.

Rate limiting

The data from the API is intended to be cached on the client side, and polled every hour. For development purposes, it is ok to use it as frequently as necessary. However if the same user polls the API too frequently (more than 10 requests in 10 seconds), it will be rate-limited and calls may fail.

Server Responses

The server responds with standard HTTP status codes:

  • 200 OK - the request was successful.
  • 401 Unauthorized - authentication failed or user doesn't have permissions for requested operation.
  • 404 Not Found - resource was not found.

API Methods

GET /countries

This methods outputs all the data about the different destinations, in a JSON format

Sample Request

curl --request GET \
  --url ' http://api.tripsguard.com/countries ' \
  --user '<your_username>:<your_apikey>'

Sample Response

{
  "data": [
    {
      "name": "Seychelles",
      "content": "html…",
      "quarantine": "14 days in authorized location",
      "public_transportation": "Operating",
      "masks": "Not required",
      "restaurants": "Open under restrictions",
      "covid_test": "Required to enter"
    },
    {
      "name": "Guyana",
      "content": "html…",
      "quarantine": "Only if showing symptoms",
      "public_transportation": "Limited",
      "masks": "Required",
      "restaurants": "Open for takeout/delivery",
      "covid_test": "Health questionnaire upon arrival"
    },
  ]
}