API version v3 v2
Start here
Countries
Objects
Cities
Objects
Phrases
Legal

Basic

BasicStartupBusiness
Name Type Description
slug String Sanitized country name
name.common String Common country name - usually the one displayed on the UI
name.official String Official country name
code.alpha2 String ISO 3166-1 alpha-2 two-letter country code
code.alpha3 String ISO 3166-1 alpha-3 three-letter country code
code.numeric String ISO 3166-1 numeric three-digit country code
languages.name String Language name
languages.type String Language type (for now only OFFICIAL)
languages.alpha2 String Language ISO 639-1 two-letter code, if available
languages.alpha3 String Language ISO 639-3 three-letter code
location.region.id String Country region (AFRICA, AMERICAS, ASIA, EUROPE or OTHER)
location.region.name String Country region name
location.subregion.id String Country subregion (AUSTRALIA_AND_NEW_ZEALAND, CARIBBEAN, CENTRAL_AMERICA, CENTRAL_ASIA, EASTERN_AFRICA, EASTERN_ASIA, EASTERN_EUROPE, MELANESIA, MICRONESIA, MIDDLE_AFRICA, NORTHERN_AFRICA, NORTHERN_AMERICA, NORTHERN_EUROPE, POLYNESIA, SOUTH_AMERICA, SOUTH_EASTERN_ASIA, SOUTHERN_AFRICA, SOUTHERN_ASIA, SOUTHERN_EUROPE, WESTERN_AFRICA, WESTERN_ASIA, WESTERN_EUROPE)
location.subregion.name String Country subregion
location.geoJson String Url of geoJSON data
capital.name String Name of the capital city
capital.slug String Sanitized city name
capital.coordinates.latitude double Latitude in decimal degrees
capital.coordinates.longitude double Longitude in decimal degrees
capital.timeZone String Time zone ID (full list)
capital.href String Link to the city information within The Basetrip API
timeZone.minUtcTimeOffset int Minimum time offset in minutes in the country (UTC)
timeZone.maxUtcTimeOffset int Maximum time offset in minutes in the country (UTC)
timeZone.minUtcTimeDstOffset int Minimum time offset in minutes in the country (UTC) during DST
timeZone.maxUtcTimeDstOffset int Maximum time offset in minutes in the country (UTC) during DST
unions Array List of unions the country is part of. Possible entries: EUROPEAN_UNION, EUROPEAN_ECONOMIC_AREA, SCHENGEN_AREA
flag.png String Link to the country flag in PNG format (512px in width)
flag.svg String Link to the country flag in SVG format
flag.emoji String Emoji (UTF-8 character) representing the country flag
isSovereignState boolean Determines whether country is sovereign state or not (i.e. constituent state, unincorporated and organized territory etc.)
measurementSystem String METRIC_SYSTEM, IMPERIAL_SYSTEM, UNITED_STATES_CUSTOMARY_SYSTEM or BURMESE_SYSTEM
wikipediaUrl String URL of Wikipedia entry about the country
governmentTravelInfoUrl String Government travel information URL, can be available only if from is defined
BasicStartupBusiness
Name Type Description
textual.title String Country name
textual.sections.id[LOCATION].body String Country location
textual.sections.id[SUMMARY].body String Country language, measurement system and time zone 
{
  "slug": "france",
  "name": {
    "common": "France",
    "official": "French Republic"
  },
  "code": {
    "alpha2": "FR",
    "alpha3": "FRA",
    "numeric": "250"
  },
  "languages": [
    {
      "name": "French",
      "type": "OFFICIAL",
      "alpha2": "fr",
      "alpha3": "fra"
    }
  ],
  "location": {
    "region": {
      "id": "EUROPE",
      "name": "Europe"
    },
    "subregion": {
      "id": "WESTERN_EUROPE",
      "name": "Western Europe"
    },
    "geoJson": "https://assets.thebasetrip.com/api/v2/countries/maps/france.geo.json"
  },
  "capital": {
    "name": "Paris",
    "slug": "paris",
    "coordinates": {
      "latitude": 48.856614,
      "longitude": 2.3522219
    },
    "timeZone": "Europe/Paris",
    "href": "http://api.localhost:9000/v3/cities/paris"
  },
  "timeZone": {
    "minUtcTimeOffset": 60,
    "maxUtcTimeOffset": 60,
    "minUtcTimeDstOffset": 120,
    "maxUtcTimeDstOffset": 120
  },
  "unions": [
    "EUROPEAN_UNION",
    "EUROPEAN_ECONOMIC_AREA",
    "SCHENGEN_AREA"
  ],
  "flag": {
    "png": "https://assets.thebasetrip.com/api/v2/countries/flags/france.png",
    "svg": "https://assets.thebasetrip.com/api/v2/countries/flags/france.svg",
    "emoji": "🇫🇷"
  },
  "isSovereignState": true,
  "measurementSystem": "METRIC_SYSTEM",
  "wikipediaUrl": "https://en.wikipedia.org/wiki/France",
  "governmentTravelInfoUrl": "https://www.gov.uk/foreign-travel-advice/france",
  "textual": {
    "title": "France",
    "sections": [
      {
        "id": "LOCATION",
        "body": [
          "France is located in Western Europe."
        ]
      },
      {
        "id": "SUMMARY",
        "body": [
          "Official language is French. France uses metric system (kilograms, centimeters, °C). Time zone is UTC+01:00 with daylight saving time."
        ]
      }
    ]
  }
}