travel

Holidays

Find the holidays observed in a particular country

Introduction

List holidays observed in a country. Holidays may be at the country or region level.

Holiday types are:

Public - public holiday
Bank - banks and offices are closed
School - schools are closed
Authorities - Government or other authorities are closed
Optional - A day where a majority of people take the day off
Observance - Optional day off, typically unpaid

Features

Countries

Get the list of countries that are supported by this API

List

List the holiday dates for a given country and year

Pricing

Endpoint	Credits	Quotas
Countries	Base	None
List	Base	None

Base request price is 0.000001 credits per request

Example

Countries 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"
        }
    ]
}