Basic

BasicStartupBusinessEnterprise
Name Type Description
name.sanitized String Sanitized country name
name.common String Common country name - usually the one displayed on the UI
name.official String Official country name
name.native.language String Language code
name.native.type String Country name type (OFFICIAL, COMMON)
name.native.value String Country name in defined language
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.code String Language ISO 639-3 three-letter code, in the other parts of the API it's as a language parameter
languages.type String Language type (for now only OFFICIAL)
languages.name String Language name in English
location.region String Country region (Africa, Americas, Asia, Europe or Other)
location.subregion String Country subregion
location.geoJson String Url of geoJSON data
capital.name String Name of the capital city
capital.coordinates.latitude double Latitude in decimal degrees
capital.coordinates.longitude double Longitude in decimal degrees
capital.timeZone String Time zone ID (full list)
ituRegion int The International Telecommunication Union region (1, 2 or 3)
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
BasicStartupBusinessEnterprise
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
{
  "name": {
    "sanitized": "france",
    "common": "France",
    "official": "French Republic",
    "native": [
      {
        "language": "fra",
        "type": "COMMON",
        "value": "France"
      },
      {
        "language": "fra",
        "type": "OFFICIAL",
        "value": "République française"
      }
    ]
  },
  "code": {
    "alpha2": "FR",
    "alpha3": "FRA",
    "numeric": "250"
  },
  "languages": [
    {
      "name": "French",
      "type": "OFFICIAL",
      "code": "fra"
    }
  ],
  "location": {
    "region": "Europe",
    "subregion": "Western Europe",
    "geoJson": "https://assets.thebasetrip.com/api/v2/countries/maps/france.geo.json"
  },
  "capital": {
    "name": "Paris",
    "coordinates": {
      "latitude": 48.856614,
      "longitude": 2.3522219
    },
    "timeZone": "Europe/Paris"
  },
  "ituRegion": 1,
  "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",
  "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."
        ]
      }
    ]
  }
}