Getting started

Welcome to The Basetrip's API documentation. Here you will find all the info you need to know to get started using our API, including endpoints & sample responses.

Getting the API key

To get the API key you need to subscribe to one of our API plans meaning you will have to register and go through the checkout process. After your payment is successful you will receive an API key which you can then immediately use with The Basetrip API.

Making requests

There are two main endpoints - one for country list and one for country details . For each endpoint we provided a sample request and response.

Base URL is

When you receive your API key, use it as x-api-key header on every request.

The only supported type is application/json content type.

i18n (internationalization)

The Basetrip currently supports 3 languages: English (en), French (fr) and Croatian (hr). Language is chosen by sending alpha-2 code of the requested language within the Accept-Language header. If no Accept-Language is set or you request language we don't support, en (English) is returned by default. Server will always respond with Content-Language header which will always be one of the supported languages.

i18n is supported only on Business and Enterprise plans (which contain textual data) per request. Additional languages can be requested and are implemented on case-by-case basis.


If you need help feel free to send us a message via email or chat.