Country details

BasicStartupBusiness
GET/countries/{id}

Get all the details about a specific country.

Name Type Required Description
{id} path parameter String required sanitized country name or alpha-2 code
from query parameter String optional sanitized country name 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/v2/countries/france?from=spain' \
     --header 'Accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'
curl --request GET \
        --url 'https://api.thebasetrip.com/v2/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
alcohol Object Alcohol category
drugs Object Drugs category
prostitution Object Prostitution category
religion Object Religion category
emergency Object Emergency category
embassy Object Embassy category
{
  "basic": {
    "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": [
      {
        "code": "fra",
        "type": "OFFICIAL",
        "name": "French"
      }
    ],
    "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"
    },
    "measurementSystem": "METRIC",
    "ituRegion": 1,
    "timeZone": {
      "minUtcTimeOffset": 60,
      "maxUtcTimeOffset": 60,
      "minUtcTimeDstOffset": 120,
      "maxUtcTimeDstOffset": 120
    },
    "flag": {
      "png": "https://assets.thebasetrip.com/api/v2/countries/flags/france.png",
      "svg": "https://assets.thebasetrip.com/api/v2/countries/flags/france.svg"
    },
    "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": {
    "name": {
      "short": "euro",
      "full": "euro"
    },
    "code": "EUR",
    "symbol": "€",
    "subunit": {
      "name": "Cent",
      "ratio": 100
    },
    "denominations": [
      {
        "type": "BANKNOTE",
        "value": 500,
        "displayAs": "5",
        "isSubunit": false
      },
      {
        "type": "COIN",
        "value": 5,
        "displayAs": "5",
        "isSubunit": true
      },
      {
        "type": "BANKNOTE",
        "value": 10000,
        "displayAs": "100",
        "isSubunit": false
      },
      {
        "type": "COIN",
        "value": 20,
        "displayAs": "20",
        "isSubunit": true
      },
      {
        "type": "BANKNOTE",
        "value": 20000,
        "displayAs": "200",
        "isSubunit": false
      },
      {
        "type": "BANKNOTE",
        "value": 50000,
        "displayAs": "500",
        "isSubunit": false
      },
      {
        "type": "COIN",
        "value": 100,
        "displayAs": "1",
        "isSubunit": false
      },
      {
        "type": "BANKNOTE",
        "value": 1000,
        "displayAs": "10",
        "isSubunit": false
      },
      {
        "type": "COIN",
        "value": 1,
        "displayAs": "1",
        "isSubunit": true
      },
      {
        "type": "COIN",
        "value": 200,
        "displayAs": "2",
        "isSubunit": false
      },
      {
        "type": "BANKNOTE",
        "value": 2000,
        "displayAs": "20",
        "isSubunit": false
      },
      {
        "type": "COIN",
        "value": 10,
        "displayAs": "10",
        "isSubunit": true
      },
      {
        "type": "COIN",
        "value": 50,
        "displayAs": "50",
        "isSubunit": true
      },
      {
        "type": "BANKNOTE",
        "value": 5000,
        "displayAs": "50",
        "isSubunit": false
      },
      {
        "type": "COIN",
        "value": 2,
        "displayAs": "2",
        "isSubunit": true
      }
    ],
    "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 euros. Euro is subdivided into 100 cents. Coins come in denominations of 2 and 1 euro and 50, 20, 10, 5, 2 and 1 cent."
          ]
        }
      ]
    }
  },
  "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": "FULL",
      "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": [
            "No adapter or transformer 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",
            "from": {
              "type": "CURRENCY",
              "currency": "euro",
              "amount": 0.5,
              "amountInteger": 50,
              "displayAs": "€0.50"
            },
            "to": {
              "type": "CURRENCY",
              "currency": "euro",
              "amount": 1,
              "amountInteger": 100,
              "displayAs": "€1.00"
            }
          }
        ]
      },
      {
        "category": "HOTEL_HOUSEKEEPER",
        "frequency": "PER_DAY",
        "isIllegal": false,
        "isOffensive": false,
        "workersRelyOnTips": false,
        "tip": [
          {
            "expectations": "EXPECTED",
            "amount": {
              "type": "CURRENCY",
              "currency": "euro",
              "amount": 1.5,
              "amountInteger": 150,
              "displayAs": "€1.50"
            }
          }
        ]
      },
      {
        "category": "HOTEL_CONCIERGE",
        "isIllegal": false,
        "isOffensive": false,
        "workersRelyOnTips": false,
        "tip": [
          {
            "expectations": "EXPECTED",
            "from": {
              "type": "CURRENCY",
              "currency": "euro",
              "amount": 8,
              "amountInteger": 800,
              "displayAs": "€8.00"
            },
            "to": {
              "type": "CURRENCY",
              "currency": "euro",
              "amount": 20,
              "amountInteger": 2000,
              "displayAs": "€20.00"
            }
          }
        ]
      },
      {
        "category": "RESTAURANT",
        "includedServiceCharge": "ALWAYS",
        "isIllegal": false,
        "isOffensive": false,
        "workersRelyOnTips": false,
        "tip": [
          {
            "expectations": "EXPECTED",
            "serviceQuality": "EXCELLENT",
            "amount": {
              "type": "PERCENTAGE",
              "amount": 10
            }
          },
          {
            "expectations": "NOT_EXPECTED",
            "serviceQuality": "BAD",
            "amount": {
              "type": "NONE"
            }
          }
        ]
      },
      {
        "category": "BAR_CAFFE",
        "isIllegal": false,
        "isOffensive": false,
        "workersRelyOnTips": false,
        "tip": [
          {
            "expectations": "EXPECTED",
            "from": {
              "type": "CURRENCY",
              "currency": "euro",
              "amount": 1,
              "amountInteger": 100,
              "displayAs": "€1.00"
            },
            "to": {
              "type": "CURRENCY",
              "currency": "euro",
              "amount": 2,
              "amountInteger": 200,
              "displayAs": "€2.00"
            }
          }
        ]
      },
      {
        "category": "SPA",
        "placeToTip": "RECEPTION",
        "isIllegal": false,
        "isOffensive": false,
        "workersRelyOnTips": false,
        "tip": [
          {
            "expectations": "NOT_EXPECTED",
            "from": {
              "type": "PERCENTAGE",
              "amount": 10
            },
            "to": {
              "type": "PERCENTAGE",
              "amount": 20
            }
          }
        ]
      },
      {
        "category": "TOUR_GUIDE",
        "isIllegal": false,
        "isOffensive": false,
        "workersRelyOnTips": false,
        "tip": [
          {
            "expectations": "EXPECTED",
            "from": {
              "type": "CURRENCY",
              "currency": "euro",
              "amount": 2,
              "amountInteger": 200,
              "displayAs": "€2.00"
            },
            "to": {
              "type": "CURRENCY",
              "currency": "euro",
              "amount": 5,
              "amountInteger": 500,
              "displayAs": "€5.00"
            }
          }
        ]
      },
      {
        "category": "TOUR_BUS_DRIVER",
        "frequency": "PER_DAY",
        "isIllegal": false,
        "isOffensive": false,
        "workersRelyOnTips": false,
        "tip": [
          {
            "expectations": "EXPECTED",
            "from": {
              "type": "CURRENCY",
              "currency": "euro",
              "amount": 1,
              "amountInteger": 100,
              "displayAs": "€1.00"
            },
            "to": {
              "type": "CURRENCY",
              "currency": "euro",
              "amount": 2,
              "amountInteger": 200,
              "displayAs": "€2.00"
            }
          }
        ]
      },
      {
        "category": "TAXI_DRIVER",
        "isIllegal": false,
        "isOffensive": false,
        "workersRelyOnTips": false,
        "tip": [
          {
            "expectations": "EXPECTED",
            "amount": {
              "type": "PERCENTAGE",
              "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."
          ]
        },
        {
          "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": "IDP",
      "textual": {
        "title": "Driving license",
        "sections": [
          {
            "id": "SUMMARY_SHORT",
            "body": [
              "Only original license is required"
            ]
          },
          {
            "id": "SUMMARY",
            "body": [
              "Since both Spain 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": "Intermarché"
          },
          {
            "name": "Carrefour"
          },
          {
            "name": "Total"
          }
        ],
        "fuel": [
          {
            "type": "DIESEL",
            "localNames": [
              "Gazole",
              "Diesel",
              "Gasoil"
            ]
          },
          {
            "type": "PETROL",
            "localNames": [
              "Sans plomb (SP) (95/98)"
            ]
          }
        ]
      },
      "entities": [
        {
          "name": "Autoroute Info",
          "url": "http://www.autorouteinfo.fr",
          "type": "TRAFFIC_NEWS"
        },
        {
          "name": "ASFA",
          "url": "http://www.autoroutes.fr",
          "type": "MOTORWAYS_TOLLS"
        }
      ],
      "textual": {
        "title": "On the road",
        "sections": [
          {
            "id": "FUEL",
            "body": [
              "Diesel options are called Gazole, Diesel or Gasoil.",
              "Petrol (unleaded) gas option is called Sans plomb (SP) (95/98). Petrol costs about €1.25 per liter."
            ]
          },
          {
            "id": "PETROL_STATIONS",
            "body": [
              "Most popular petrol stations in France are Shell, Intermarché, Carrefour and Total."
            ]
          },
          {
            "id": "ENTITIES",
            "body": [
              "For general news on France's traffic use Autoroute Info. For news on France’s motorways and tolls use ASFA."
            ]
          }
        ]
      }
    },
    "rules": {
      "side": "RIGHT",
      "transmission": "MANUAL",
      "allowedTurnOnRed": false,
      "alcoholLimitPercentage": 0.05,
      "speedLimits": [
        {
          "roadType": "UNDIVIDED_HIGHWAY",
          "limit": "90"
        },
        {
          "roadType": "EXPRESSWAY",
          "limit": "110"
        },
        {
          "roadType": "MOTORWAY",
          "limit": "130"
        },
        {
          "roadType": "WITHIN_TOWNS",
          "limit": "50"
        }
      ],
      "textual": {
        "title": "Road rules",
        "sections": [
          {
            "id": "GENERAL",
            "body": [
              "In France you drive on the right. Most cars have manual transmission (stick)."
            ]
          },
          {
            "id": "SPEED_LIMITS",
            "body": [
              "Unless otherwise posted, the speed limits for cars and motorcycles are as follows: 90 km/h (55 mph) on undivided highways, 110 km/h (68 mph) on expressways, 130 km/h (80 mph) on motorways and 50 km/h (31 mph) in all built-up areas."
            ]
          },
          {
            "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 Spain, dial + or 00 (exit code for Spain), then 33 (the country code for France), then the area code (without the initial 0) and the local number."
          ]
        },
        {
          "id": "LOCAL_CALL_EXAMPLE",
          "body": [
            "05 1234567"
          ]
        },
        {
          "id": "INTERNATIONAL_CALL_EXAMPLE",
          "body": [
            "+ 33 5 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 5 ."
          ]
        }
      ]
    }
  },
  "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 27% slower than in Spain (12.1 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": 12.48,
        "amountInteger": 1248,
        "currency": "EUR",
        "displayAs": "€12.48"
      }
    },
    "carriers": [
      {
        "name": "Bouygues Télécom",
        "website": "https://www.bouyguestelecom.fr/"
      },
      {
        "name": "Free",
        "website": "http://www.free.fr/"
      },
      {
        "name": "Orange",
        "website": "http://www.orange.com/"
      },
      {
        "name": "SFR",
        "website": "http://www.sfr.fr/"
      }
    ],
    "capabilities": [
      {
        "name": "UMTS 900",
        "type": "TYPE_3G"
      },
      {
        "name": "GSM 1800",
        "type": "TYPE_2G"
      },
      {
        "name": "UMTS 2100",
        "type": "TYPE_3G"
      },
      {
        "name": "LTE 1800 (3)",
        "type": "TYPE_4G"
      },
      {
        "name": "LTE 2600 (7)",
        "type": "TYPE_4G"
      },
      {
        "name": "GSM 900",
        "type": "TYPE_2G"
      },
      {
        "name": "LTE 800 (20)",
        "type": "TYPE_4G"
      },
      {
        "name": "LTE 700 (28)",
        "type": "TYPE_4G"
      }
    ],
    "textual": {
      "title": "Mobile phone",
      "sections": [
        {
          "id": "SIM_CARD_TELECOMS",
          "body": [
            "You can buy a SIM card for about €12.48 (€12.48), 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 Spain 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 have smaller roaming surcharge than in other countries."
          ]
        }
      ]
    }
  },
  "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": "TICK_BORNE_ENCEPHALITIS",
          "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."
            ]
          }
        ]
      }
    }
  },
  "alcohol": {
    "legal": true,
    "minimumDrinkingAgeBeerWine": "NONE",
    "minimumDrinkingAgeSpirits": "NONE",
    "minimumPurchaseAgeBeerWine": "18",
    "minimumPurchaseAgeSpirits": "18",
    "consumption": {
      "averageLitersPerCapita": 12.2
    },
    "textual": {
      "title": "Alcohol",
      "sections": [
        {
          "id": "LEGALITY",
          "body": [
            "Legal"
          ]
        },
        {
          "id": "SUMMARY",
          "body": [
            "Minimum age to purchase alcohol is 18 years old, while to drink it is not defined."
          ]
        },
        {
          "id": "DRIVING",
          "body": [
            "Blood-alcohol limit is 0.05% (0.5g per litre of blood) while driving."
          ]
        }
      ]
    }
  },
  "drugs": {
    "types": [
      {
        "type": "CANNABIS",
        "purpose": "POSSESSION",
        "useType": "PERSONAL",
        "legal": false,
        "decriminalized": false
      }
    ],
    "textual": {
      "title": "Drugs",
      "sections": [
        {
          "id": "SUMMARY",
          "body": [
            "Drugs (including cannabis/marijuana) are illegal & criminalized which means you are risking jail time with other penalties (fine, community service, rehabilitation) if you are caught."
          ]
        }
      ]
    }
  },
  "prostitution": {
    "legal": {
      "payForSex": false,
      "offerServices": true,
      "brothels": false
    },
    "textual": {
      "title": "Prostitution",
      "sections": [
        {
          "id": "LEGALITY",
          "body": [
            "Semi-legal (only offering services)"
          ]
        },
        {
          "id": "SUMMARY",
          "body": [
            "Even though prostitution is strictly speaking legal, consuming it is not - meaning that if you get caught using the services of a prostitute, you will be fined as a client, not a prostitute herself. Brothels are illegal."
          ]
        }
      ]
    }
  },
  "religion": {
    "distribution": [
      {
        "type": "CHRISTIANITY",
        "percentage": 63
      },
      {
        "type": "ISLAM",
        "percentage": 7.5
      },
      {
        "type": "UNAFFILIATED",
        "percentage": 28
      },
      {
        "type": "HINDUISM",
        "percentage": 0.05
      },
      {
        "type": "BUDDHISM",
        "percentage": 0.5
      },
      {
        "type": "FOLK",
        "percentage": 0.3
      },
      {
        "type": "OTHER",
        "percentage": 0.2
      },
      {
        "type": "JUDAISM",
        "percentage": 0.5
      }
    ]
  },
  "emergency": {
    "numbers": [
      {
        "type": "UNIVERSAL",
        "numbers": [
          "112"
        ]
      }
    ]
  },
  "embassy": {
    "name": "Embassy of Spain",
    "address": "22, Av. Marceau, 75381 Paris Cédex 08, Paris, France",
    "phone": "+ 33 144 43 18 00",
    "fax": "0 147 23 59 55",
    "website": "http://www.exteriores.gob.es/Embajadas/Paris/es/Paginas/inicio.aspx"
  }
}