How Can We Help?

Get country

You are here:
← All Topics

Getting a country is a GET request.

api.worldholidayapi.com/v1/countries/111?key=YOUR_API_KEY
OR
api.worldholidayapi.com/v1/countries/IT?key=YOUR_API_KEY
OR
api.worldholidayapi.com/v1/countries/it?key=YOUR_API_KEY

As you can see, you can request country by alpha_2 (case insensitive) code and also by id.

You will see results similar to this:

{
    "requests": {
        "total": 10000,
        "used": 16,
        "remaining": 9984,
        "resets": "2019-11-29T13:02:59"
    },
    "country": [
        {
            "id": 111,
            "name": "Italy",
            "alpha_2": "IT",
            "alpha_3": "ITA",
            "country_code": 380,
            "iso_3166_2": "ISO 3166-2:IT",
            "region": "Europe",
            "sub_region": "Southern Europe",
            "intermediate_region": "",
            "region_code": "150",
            "sub_region_code": "039",
            "intermediate_region_code": "",
            "flag": "https://www.countryflags.io/IT/flat/64.png",
            "url": "/v1/countries/IT"
        }
    ]
}

Each request counts towards your limits.