Country details

BasicStartupBusiness
GET/countries/{id}

Get all the details about a specific country.

Name Type Required Description
{id} path parameter String required country's slug or alpha-2 code
from query parameter String optional country's slug or alpha-2 code if you want to include comparison data which is available on some data categories (eg. electricity)
curl --request GET \
     --url 'https://api.thebasetrip.com/v3/countries/france?from=spain' \
     --header 'Accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'
curl --request GET \
        --url 'https://api.thebasetrip.com/v3/countries/fr?from=es' \
        --header 'Accept: application/json' \
        --header 'x-api-key: YOUR_API_KEY'
Name Type Description
basic Object Basic category
currency Object Currency category
electricity Object Electricity category
tipping Object Tipping category
atms Object ATMs category
creditDebitCard Object Credit & debit card category
driving Object Driving category
dialCode Object Dial code category
internet Object Internet category
mobilePhone Object Mobile phone category
health Object Health category
emergency Object Emergency category
{
  "basic": {
    "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."
          ]
        }
      ]
    }
  },
  "currency": {
    "currencies": [
      {
        "name": {
          "short": "euro",
          "full": "euro"
        },
        "code": "EUR",
        "symbol": "€",
        "subunit": {
          "name": "Cent",
          "ratio": 100
        },
        "denominations": [
          {
            "type": "COIN",
            "value": 1,
            "displayAs": "1",
            "isSubunit": true
          },
          {
            "type": "COIN",
            "value": 2,
            "displayAs": "2",
            "isSubunit": true
          },
          {
            "type": "COIN",
            "value": 5,
            "displayAs": "5",
            "isSubunit": true
          },
          {
            "type": "COIN",
            "value": 10,
            "displayAs": "10",
            "isSubunit": true
          },
          {
            "type": "COIN",
            "value": 20,
            "displayAs": "20",
            "isSubunit": true
          },
          {
            "type": "COIN",
            "value": 50,
            "displayAs": "50",
            "isSubunit": true
          },
          {
            "type": "COIN",
            "value": 100,
            "displayAs": "1",
            "isSubunit": false
          },
          {
            "type": "COIN",
            "value": 200,
            "displayAs": "2",
            "isSubunit": false
          },
          {
            "type": "BANKNOTE",
            "value": 500,
            "displayAs": "5",
            "isSubunit": false
          },
          {
            "type": "BANKNOTE",
            "value": 1000,
            "displayAs": "10",
            "isSubunit": false
          },
          {
            "type": "BANKNOTE",
            "value": 2000,
            "displayAs": "20",
            "isSubunit": false
          },
          {
            "type": "BANKNOTE",
            "value": 5000,
            "displayAs": "50",
            "isSubunit": false
          },
          {
            "type": "BANKNOTE",
            "value": 10000,
            "displayAs": "100",
            "isSubunit": false
          },
          {
            "type": "BANKNOTE",
            "value": 20000,
            "displayAs": "200",
            "isSubunit": false
          },
          {
            "type": "BANKNOTE",
            "value": 50000,
            "displayAs": "500",
            "isSubunit": false
          }
        ]
      }
    ],
    "textual": {
      "title": "Currency",
      "sections": [
        {
          "id": "SUMMARY",
          "body": [
            "France uses the euro (symbol: €), code EUR."
          ]
        },
        {
          "id": "DENOMINATIONS",
          "body": [
            "Banknotes come in denominations of 500, 200, 100, 50, 20, 10 and 5 euro. Euro is subdivided into 100 cents. Coins come in denominations of 2 and 1 euros and 50, 20, 10, 5, 2 and 1 cents."
          ]
        }
      ]
    }
  },
  "electricity": {
    "frequencies": [
      50
    ],
    "voltages": [
      230
    ],
    "sockets": [
      {
        "type": "C",
        "image": {
          "png": "https://assets.thebasetrip.com/api/v2/sockets/C.png",
          "svg": "https://assets.thebasetrip.com/api/v2/sockets/C.svg"
        }
      },
      {
        "type": "E",
        "image": {
          "png": "https://assets.thebasetrip.com/api/v2/sockets/E.png",
          "svg": "https://assets.thebasetrip.com/api/v2/sockets/E.svg"
        }
      }
    ],
    "compatibility": {
      "frequency": "FULL",
      "voltage": "FULL",
      "sockets": "NONE",
      "converter": "NOT_NEEDED"
    },
    "textual": {
      "title": "Sockets & plugs",
      "sections": [
        {
          "id": "SUMMARY",
          "body": [
            "France uses 230V, 50Hz with sockets and plugs Type C and Type E."
          ]
        },
        {
          "id": "COMPATIBILITY",
          "body": [
            "Adapter required, transformer not needed"
          ]
        }
      ]
    }
  },
  "tipping": {
    "categories": [
      {
        "category": "OVERALL",
        "isIllegal": false,
        "isOffensive": false,
        "workersRelyOnTips": false,
        "tip": [
          {
            "expectations": "EXPECTED"
          }
        ]
      },
      {
        "category": "HOTEL_PORTER",
        "frequency": "PER_BAG",
        "isIllegal": false,
        "isOffensive": false,
        "workersRelyOnTips": false,
        "tip": [
          {
            "expectations": "EXPECTED",
            "type": "CURRENCY",
            "from": {
              "amount": 0.5,
              "amountInteger": 50,
              "currency": "EUR",
              "displayAs": "€0.50"
            },
            "to": {
              "amount": 1,
              "amountInteger": 100,
              "currency": "EUR",
              "displayAs": "€1.00"
            }
          }
        ]
      },
      {
        "category": "HOTEL_HOUSEKEEPER",
        "frequency": "PER_DAY",
        "isIllegal": false,
        "isOffensive": false,
        "workersRelyOnTips": false,
        "tip": [
          {
            "expectations": "EXPECTED",
            "type": "CURRENCY",
            "amount": {
              "amount": 1.5,
              "amountInteger": 150,
              "currency": "EUR",
              "displayAs": "€1.50"
            }
          }
        ]
      },
      {
        "category": "HOTEL_CONCIERGE",
        "isIllegal": false,
        "isOffensive": false,
        "workersRelyOnTips": false,
        "tip": [
          {
            "expectations": "EXPECTED",
            "type": "CURRENCY",
            "from": {
              "amount": 8,
              "amountInteger": 800,
              "currency": "EUR",
              "displayAs": "€8.00"
            },
            "to": {
              "amount": 20,
              "amountInteger": 2000,
              "currency": "EUR",
              "displayAs": "€20.00"
            }
          }
        ]
      },
      {
        "category": "RESTAURANT",
        "includedServiceCharge": "ALWAYS",
        "isIllegal": false,
        "isOffensive": false,
        "workersRelyOnTips": false,
        "tip": [
          {
            "expectations": "EXPECTED",
            "serviceQuality": "EXCELLENT",
            "type": "PERCENTAGE",
            "amount": {
              "amount": 10
            }
          },
          {
            "expectations": "NOT_EXPECTED",
            "serviceQuality": "BAD",
            "type": "NONE"
          }
        ]
      },
      {
        "category": "BAR_CAFFE",
        "isIllegal": false,
        "isOffensive": false,
        "workersRelyOnTips": false,
        "tip": [
          {
            "expectations": "EXPECTED",
            "type": "CURRENCY",
            "from": {
              "amount": 1,
              "amountInteger": 100,
              "currency": "EUR",
              "displayAs": "€1.00"
            },
            "to": {
              "amount": 2,
              "amountInteger": 200,
              "currency": "EUR",
              "displayAs": "€2.00"
            }
          }
        ]
      },
      {
        "category": "SPA",
        "placeToTip": "RECEPTION",
        "isIllegal": false,
        "isOffensive": false,
        "workersRelyOnTips": false,
        "tip": [
          {
            "expectations": "NOT_EXPECTED",
            "type": "PERCENTAGE",
            "from": {
              "amount": 10
            },
            "to": {
              "amount": 20
            }
          }
        ]
      },
      {
        "category": "TOUR_GUIDE",
        "isIllegal": false,
        "isOffensive": false,
        "workersRelyOnTips": false,
        "tip": [
          {
            "expectations": "EXPECTED",
            "type": "CURRENCY",
            "from": {
              "amount": 2,
              "amountInteger": 200,
              "currency": "EUR",
              "displayAs": "€2.00"
            },
            "to": {
              "amount": 5,
              "amountInteger": 500,
              "currency": "EUR",
              "displayAs": "€5.00"
            }
          }
        ]
      },
      {
        "category": "TOUR_BUS_DRIVER",
        "frequency": "PER_DAY",
        "isIllegal": false,
        "isOffensive": false,
        "workersRelyOnTips": false,
        "tip": [
          {
            "expectations": "EXPECTED",
            "type": "CURRENCY",
            "from": {
              "amount": 1,
              "amountInteger": 100,
              "currency": "EUR",
              "displayAs": "€1.00"
            },
            "to": {
              "amount": 2,
              "amountInteger": 200,
              "currency": "EUR",
              "displayAs": "€2.00"
            }
          }
        ]
      },
      {
        "category": "TAXI_DRIVER",
        "isIllegal": false,
        "isOffensive": false,
        "workersRelyOnTips": false,
        "tip": [
          {
            "expectations": "EXPECTED",
            "type": "PERCENTAGE",
            "amount": {
              "amount": 10
            }
          }
        ]
      }
    ],
    "textual": {
      "title": "Tipping",
      "sections": [
        {
          "id": "SUMMARY",
          "body": [
            "Tipping is quite common in France and it's good etiquette to leave one. How much money you leave depends on the service and how happy you were with it. Receipts always include a service charge."
          ]
        },
        {
          "id": "SUMMARY_SHORT",
          "body": [
            "Expected to tip"
          ]
        }
      ]
    }
  },
  "atms": {
    "coverage": "VERY_COMMON",
    "localNames": [
      "distributeur",
      "distributeurs automatiques de billets (DAB)"
    ],
    "textual": {
      "title": "ATMs",
      "sections": [
        {
          "id": "SUMMARY",
          "body": [
            "Automatic teller machines (local names: distributeur or distributeurs automatiques de billets (DAB)) are very common in France. You can find them in both large & small cities, tourist areas etc.",
            "You do not need a chip & PIN card to use an ATM — your standard magnetic card will work fine."
          ]
        },
        {
          "id": "COVERAGE",
          "body": [
            "Very common"
          ]
        }
      ]
    }
  },
  "creditDebitCard": {
    "acceptanceInternationalCards": "VERY_HIGH",
    "cards": [
      {
        "brand": "VISA",
        "acceptance": "HIGH"
      },
      {
        "brand": "MASTERCARD",
        "acceptance": "HIGH"
      },
      {
        "brand": "MAESTRO",
        "acceptance": "HIGH"
      },
      {
        "brand": "AMERICAN_EXPRESS",
        "acceptance": "MEDIUM"
      },
      {
        "brand": "DINERS_CLUB",
        "acceptance": "LOW"
      },
      {
        "brand": "DISCOVER",
        "acceptance": "NONE"
      },
      {
        "brand": "JCB",
        "acceptance": "NONE"
      },
      {
        "brand": "UNION_PAY",
        "acceptance": "NONE"
      },
      {
        "brand": "RU_PAY",
        "acceptance": "NONE"
      }
    ],
    "hotlineNumbers": [
      {
        "brand": "MASTERCARD",
        "number": "0 800 90 1387",
        "isTollFree": true
      },
      {
        "brand": "VISA",
        "number": "0800 90 1179",
        "isTollFree": true
      }
    ],
    "textual": {
      "title": "Credit & debit cards",
      "sections": [
        {
          "id": "SUMMARY",
          "body": [
            "Credit cards are widely accepted within France (at hotels, shops, and restaurants, travel agencies, car-rental agencies etc.). Visa, MasterCard and Maestro are the most widely accepted. American Express is less common. Diners Club is pretty rare. Discover, JCB, UnionPay and RuPay are unknown."
          ]
        },
        {
          "id": "ACCEPTANCE",
          "body": [
            "Widely accepted"
          ]
        }
      ]
    }
  },
  "driving": {
    "license": {
      "acceptance": "ORIGINAL",
      "textual": {
        "title": "Driving license",
        "sections": [
          {
            "id": "SUMMARY_SHORT",
            "body": [
              "Only original license is required"
            ]
          },
          {
            "id": "SUMMARY",
            "body": [
              "Since both United Kingdom and France are part of the European Economic Area your driving license will be valid in France without any additional documents required. If you do not have a new plastic, credit-sized driving license you can still use your existing license."
            ]
          }
        ]
      }
    },
    "road": {
      "petrol": {
        "stations": [
          {
            "name": "Shell"
          },
          {
            "name": "Avia"
          },
          {
            "name": "Intermarché"
          },
          {
            "name": "Carrefour"
          },
          {
            "name": "Total"
          },
          {
            "name": "AS24"
          },
          {
            "name": "Esso"
          },
          {
            "name": "Système U"
          },
          {
            "name": "Leclerc"
          }
        ],
        "fuel": [
          {
            "type": "PETROL",
            "localNames": [
              "Sans plomb (SP) (95/98)",
              "essence",
              "carburant"
            ]
          },
          {
            "type": "DIESEL",
            "localNames": [
              "Gazole",
              "Diesel"
            ]
          }
        ]
      },
      "entities": [
        {
          "type": "TRAFFIC_NEWS",
          "name": "Autoroute Info",
          "website": {
            "url": "http://www.autorouteinfo.fr"
          },
          "radio": "107.7MHz"
        },
        {
          "type": "MOTORWAYS_TOLLS",
          "name": "ASFA",
          "website": {
            "url": "http://www.autoroutes.fr/"
          }
        },
        {
          "type": "TRAFFIC_NEWS",
          "name": "Autoroutes.fr",
          "website": {
            "url": "http://www.autoroutes.fr/en/Realtime-traffic-information.htm"
          },
          "radio": "107.7"
        },
        {
          "type": "ROAD_ASSISTANCE",
          "name": "Autoreoutes.fr",
          "website": {
            "url": "http://www.autoroutes.fr/en/breakdown-service.htm"
          }
        }
      ],
      "textual": {
        "title": "On the road",
        "sections": [
          {
            "id": "FUEL",
            "body": [
              "Petrol (unleaded) gas options are called Sans plomb (SP) (95/98), essence or carburant. Petrol costs about €1.25 (£1.09) per liter.",
              "Diesel options are called Gazole or Diesel."
            ]
          },
          {
            "id": "PETROL_STATIONS",
            "body": [
              "Most popular petrol stations in France are Shell, Avia, Intermarché, Carrefour, Total, AS24, Esso, Système U and Leclerc."
            ]
          },
          {
            "id": "ENTITIES",
            "body": [
              "Road assistance is available at null (Autoreoutes.fr). For general news on France's traffic use Autoroute Info or Autoroutes.fr. For news on France’s motorways and tolls use ASFA."
            ]
          }
        ]
      }
    },
    "rules": {
      "side": "RIGHT",
      "transmission": "MANUAL",
      "allowedTurnOnRed": false,
      "alcoholLimitPercentage": 0.05,
      "speedLimits": [
        {
          "roadType": "WITHIN_TOWNS",
          "limit": "50"
        },
        {
          "roadType": "RESIDENTIAL_AREA",
          "limit": "30"
        },
        {
          "roadType": "UNDIVIDED_HIGHWAY",
          "limit": "90"
        },
        {
          "roadType": "MOTORWAY",
          "limit": "130"
        },
        {
          "roadType": "EXPRESSWAY",
          "limit": "110"
        }
      ],
      "textual": {
        "title": "Road rules",
        "sections": [
          {
            "id": "GENERAL",
            "body": [
              "In France you drive on the right side. Most cars have manual transmission (stick)."
            ]
          },
          {
            "id": "SPEED_LIMITS",
            "body": [
              "Unless otherwise posted, the speed limits for cars and motorcycles are as follows: 110 km/h (68 mph) on expressways, 130 km/h (80 mph) on motorways, 30 km/h (18 mph) in residential areas, 50 km/h (31 mph) in all built-up areas and 90 km/h (55 mph) on undivided highways."
            ]
          },
          {
            "id": "TURN_ON_RED",
            "body": [
              "Right turn on red lights is strictly forbidden unless an additional green semaphore arrow allows it."
            ]
          },
          {
            "id": "ALCOHOL",
            "body": [
              "It is illegal to drive with blood alcohol content higher than 0.05%."
            ]
          }
        ]
      }
    }
  },
  "dialCode": {
    "calling": [
      "33"
    ],
    "exit": [
      "00"
    ],
    "trunk": [
      "0"
    ],
    "textual": {
      "title": "Dial code",
      "sections": [
        {
          "id": "SUMMARY",
          "body": [
            "To call France from United Kingdom, dial + or 00 (exit code for United Kingdom), then 33 (the country code for France), then the area code (without the initial 0) and the local number."
          ]
        },
        {
          "id": "LOCAL_CALL_EXAMPLE",
          "body": [
            "01 1234567"
          ]
        },
        {
          "id": "INTERNATIONAL_CALL_EXAMPLE",
          "body": [
            "+ 33 1 1234567"
          ]
        },
        {
          "id": "LOCAL_CALLS",
          "body": [
            "For local calls within France, start with the area code (with the initial 0). In the case above area code is 1 ."
          ]
        }
      ]
    }
  },
  "internet": {
    "averageSpeedKbps": 8917,
    "wifi": {
      "coverage": "VERY_HIGH"
    },
    "textual": {
      "title": "Internet",
      "sections": [
        {
          "id": "INTERNET_SPEED",
          "body": [
            "Internet speed in France is on average 8.9 Mbps which is 36% slower than in United Kingdom (13.9 Mbps)."
          ]
        },
        {
          "id": "WIFI",
          "body": [
            "WiFi coverage in France is very high. Most hotels, hostels, cafes, restaurants and bars have it."
          ]
        }
      ]
    }
  },
  "mobilePhone": {
    "dataPackage": {
      "sizeMb": 2048,
      "price": {
        "amount": 11.15,
        "amountInteger": 1115,
        "currency": "EUR",
        "displayAs": "€11.15"
      }
    },
    "carriers": [
      {
        "name": "Bouygues Télécom",
        "website": {
          "url": "https://www.bouyguestelecom.fr/"
        }
      },
      {
        "name": "Free",
        "website": {
          "url": "http://www.free.fr/"
        }
      },
      {
        "name": "Orange",
        "website": {
          "url": "http://www.orange.com/"
        }
      },
      {
        "name": "SFR",
        "website": {
          "url": "http://www.sfr.fr/"
        }
      }
    ],
    "capabilities": [
      {
        "name": "GSM 1800",
        "type": "TYPE_2G"
      },
      {
        "name": "GSM 900",
        "type": "TYPE_2G"
      },
      {
        "name": "UMTS 2100",
        "type": "TYPE_3G"
      },
      {
        "name": "UMTS 900",
        "type": "TYPE_3G"
      },
      {
        "name": "LTE 1800 (3)",
        "type": "TYPE_4G"
      },
      {
        "name": "LTE 2600 (7)",
        "type": "TYPE_4G"
      },
      {
        "name": "LTE 700 (28)",
        "type": "TYPE_4G"
      },
      {
        "name": "LTE 800 (20)",
        "type": "TYPE_4G"
      }
    ],
    "textual": {
      "title": "Mobile phone",
      "sections": [
        {
          "id": "SIM_CARD_TELECOMS",
          "body": [
            "You can buy a SIM card for about €11.15 (£9.79), which includes 2 GB of data plan. You can choose from 4 telecoms: Bouygues Télécom, Free, Orange or SFR."
          ]
        },
        {
          "id": "MOBILE_NETWORKS",
          "body": [
            "France uses similar GSM mobile networks (GSM 1800 and GSM 900) as United Kingdom so you should be able to normally use your mobile phone."
          ]
        },
        {
          "id": "ROAMING",
          "body": [
            "According to the EU regulations your messages, calls and Internet mobile data in France will cost the same as in United Kingdom. Note that there is fair-use policy which means that the use is limited to business & leisure."
          ]
        }
      ]
    }
  },
  "health": {
    "insurance": {
      "euInsuranceUrl": "http://ec.europa.eu/social/main.jsp?catId=1021&langId=en&intPageId=1737",
      "textual": {
        "title": "Health insurance",
        "sections": [
          {
            "id": "SUMMARY",
            "body": [
              "Covered via European Health Insurance Card"
            ]
          },
          {
            "id": "INSTRUCTIONS",
            "body": [
              "Make sure to bring your European Health Insurance Card (or EHIC) which allows you to receive medical treatment with the same cost as if you were a citizen of France."
            ]
          }
        ]
      }
    },
    "vaccination": {
      "policy": "NOT_REQUIRED",
      "risks": [
        {
          "type": "ROUTINE_IMMUNIZATIONS",
          "isSelective": false
        },
        {
          "type": "HEPATITIS_A",
          "isSelective": true
        },
        {
          "type": "HEPATITIS_B",
          "isSelective": true
        },
        {
          "type": "RABIES",
          "isSelective": true
        }
      ],
      "textual": {
        "title": "Vaccinations",
        "sections": [
          {
            "id": "SUMMARY",
            "body": [
              "No vaccinations are required to enter the country, but it is recommended to perform routine immunizations for your protection and to prevent the spread of infectious diseases."
            ]
          },
          {
            "id": "SELECTIVE",
            "body": [
              "These apply only to select travelers or persons on work assignments."
            ]
          }
        ]
      }
    }
  },
  "emergency": {
    "numbers": [
      {
        "type": "UNIVERSAL",
        "numbers": [
          "112"
        ]
      }
    ]
  },
  "embassy": {
    "name": "Embassy of United Kingdom in France",
    "address": "35 Rue du Faubourg Saint-Honoré, 75008 Paris, France",
    "phone": "+33 1 44 51 31 00",
    "fax": "+33 1 44 51 31 09",
    "website": "https://www.gov.uk/world/organisations/british-embassy-paris/office/british-embassy"
  }
}