Back to explore

travel

Holidays

Credits: 0.000001

Countries

POST /v1/holidays/Countries

Get the list of countries that are supported by this API

Request

{}

Response

countriesarray

Request

Response

{
    "countries": [
        {
            "code": "AR",
            "name": "Argentina"
        },
        {
            "code": "AU",
            "name": "Australia"
        },
        {
            "code": "BR",
            "name": "Brazil"
        },
        {
            "code": "CA",
            "name": "Canada"
        },
        {
            "code": "CH",
            "name": "Switzerland"
        },
        {
            "code": "CL",
            "name": "Chile"
        },
        {
            "code": "CN",
            "name": "China"
        },
        {
            "code": "CO",
            "name": "Colombia"
        },
        {
            "code": "DE",
            "name": "Germany"
        },
        {
            "code": "DK",
            "name": "Denmark"
        },
        {
            "code": "ES",
            "name": "Spain"
        },
        {
            "code": "FR",
            "name": "France"
        },
        {
            "code": "GB",
            "name": "United Kingdom"
        },
        {
            "code": "HU",
            "name": "Hungary"
        },
        {
            "code": "IT",
            "name": "Italy"
        },
        {
            "code": "JP",
            "name": "Japan"
        },
        {
            "code": "KR",
            "name": "South Korea"
        },
        {
            "code": "MX",
            "name": "Mexico"
        },
        {
            "code": "SG",
            "name": "Singapore"
        },
        {
            "code": "US",
            "name": "United States"
        },
        {
            "code": "ZA",
            "name": "South Africa"
        }
    ]
}

Credits: 0.000001

List

POST /v1/holidays/List

List the holiday dates for a given country and year

Request

country_codestring

The 2 letter country code (as defined in ISO 3166-1 alpha-2)

yearnumber

The year to list holidays for

Response

holidaysarray

Request

Response

{
    "holidays": [
        {
            "date": "2022-01-01",
            "name": "New Year's Day",
            "local_name": "New Year's Day",
            "country_code": "GB",
            "regions": [
                "GB-NIR"
            ],
            "types": [
                "Public"
            ]
        },
        {
            "date": "2022-01-03",
            "name": "New Year's Day",
            "local_name": "New Year's Day",
            "country_code": "GB",
            "regions": [
                "GB-ENG",
                "GB-WLS"
            ],
            "types": [
                "Public"
            ]
        },
        {
            "date": "2022-01-03",
            "name": "New Year's Day",
            "local_name": "New Year's Day",
            "country_code": "GB",
            "regions": [
                "GB-SCT"
            ],
            "types": [
                "Public"
            ]
        },
        {
            "date": "2022-01-04",
            "name": "New Year's Day",
            "local_name": "New Year's Day",
            "country_code": "GB",
            "regions": [
                "GB-SCT"
            ],
            "types": [
                "Public"
            ]
        },
        {
            "date": "2022-03-17",
            "name": "Saint Patrick's Day",
            "local_name": "Saint Patrick's Day",
            "country_code": "GB",
            "regions": [
                "GB-NIR"
            ],
            "types": [
                "Public"
            ]
        },
        {
            "date": "2022-04-15",
            "name": "Good Friday",
            "local_name": "Good Friday",
            "country_code": "GB",
            "regions": [],
            "types": [
                "Public"
            ]
        },
        {
            "date": "2022-04-18",
            "name": "Easter Monday",
            "local_name": "Easter Monday",
            "country_code": "GB",
            "regions": [
                "GB-ENG",
                "GB-WLS",
                "GB-NIR"
            ],
            "types": [
                "Public"
            ]
        },
        {
            "date": "2022-05-02",
            "name": "Early May Bank Holiday",
            "local_name": "Early May Bank Holiday",
            "country_code": "GB",
            "regions": [],
            "types": [
                "Public"
            ]
        },
        {
            "date": "2022-06-02",
            "name": "Spring Bank Holiday",
            "local_name": "Spring Bank Holiday",
            "country_code": "GB",
            "regions": [],
            "types": [
                "Public"
            ]
        },
        {
            "date": "2022-06-03",
            "name": "Queen’s Platinum Jubilee",
            "local_name": "Queen’s Platinum Jubilee",
            "country_code": "GB",
            "regions": [],
            "types": [
                "Public"
            ]
        },
        {
            "date": "2022-07-12",
            "name": "Battle of the Boyne",
            "local_name": "Battle of the Boyne",
            "country_code": "GB",
            "regions": [
                "GB-NIR"
            ],
            "types": [
                "Public"
            ]
        },
        {
            "date": "2022-08-01",
            "name": "Summer Bank Holiday",
            "local_name": "Summer Bank Holiday",
            "country_code": "GB",
            "regions": [
                "GB-SCT"
            ],
            "types": [
                "Public"
            ]
        },
        {
            "date": "2022-08-29",
            "name": "Summer Bank Holiday",
            "local_name": "Summer Bank Holiday",
            "country_code": "GB",
            "regions": [
                "GB-ENG",
                "GB-WLS",
                "GB-NIR"
            ],
            "types": [
                "Public"
            ]
        },
        {
            "date": "2022-11-30",
            "name": "Saint Andrew's Day",
            "local_name": "Saint Andrew's Day",
            "country_code": "GB",
            "regions": [
                "GB-SCT"
            ],
            "types": [
                "Public"
            ]
        },
        {
            "date": "2022-12-26",
            "name": "St. Stephen's Day",
            "local_name": "Boxing Day",
            "country_code": "GB",
            "regions": [],
            "types": [
                "Public"
            ]
        },
        {
            "date": "2022-12-27",
            "name": "Christmas Day",
            "local_name": "Christmas Day",
            "country_code": "GB",
            "regions": [],
            "types": [
                "Public"
            ]
        }
    ]
}