Get holidays by country

Getting the holidays for a country is a GET request to

api.worldholidayapi.com/v1/holidays?country=gb&year=2020&key=YOUR_API_KEY 

Where country is the two letter alpha code of the country (case insensitive). Year is the year you want the holidays for and you can only pass in one year. If you need holidays for multiple years, you need to make multiple requests.

Both fields are mandatory.

The response will be similar to this

{
    "requests": {
        "total": 10000,
        "used": 34,
        "remaining": 9966,
        "resets": "2019-11-29T13:02:59"
    },
    "holidays": [
        {
            "id": 656,
            "name": "New Year's Day",
            "date": "2020-01-01",
            "start": "2020-01-01 00:00:00",
            "end": "2020-01-02 00:00:00",
            "public": true,
            "type": "public",
            "language": "EN",
            "country": "GB",
            "country_url": "/api/v1/countries/gb",
            "substitute": null,
            "note": ""
        },
        {
            "id": 657,
            "name": "Mother's Day",
            "date": "2020-03-22",
            "start": "2020-03-22 00:00:00",
            "end": "2020-03-23 00:00:00",
            "public": false,
            "type": "observance",
            "language": "EN",
            "country": "GB",
            "country_url": "/api/v1/countries/gb",
            "substitute": null,
            "note": ""
        },
        {
            "id": 658,
            "name": "Good Friday",
            "date": "2020-04-10",
            "start": "2020-04-09 23:00:00",
            "end": "2020-04-10 23:00:00",
            "public": true,
            "type": "public",
            "language": "EN",
            "country": "GB",
            "country_url": "/api/v1/countries/gb",
            "substitute": null,
            "note": ""
        },
        {
            "id": 659,
            "name": "Easter Sunday",
            "date": "2020-04-12",
            "start": "2020-04-11 23:00:00",
            "end": "2020-04-12 23:00:00",
            "public": true,
            "type": "public",
            "language": "EN",
            "country": "GB",
            "country_url": "/api/v1/countries/gb",
            "substitute": null,
            "note": ""
        },
        {
            "id": 660,
            "name": "Easter Monday",
            "date": "2020-04-13",
            "start": "2020-04-12 23:00:00",
            "end": "2020-04-13 23:00:00",
            "public": true,
            "type": "public",
            "language": "EN",
            "country": "GB",
            "country_url": "/api/v1/countries/gb",
            "substitute": null,
            "note": ""
        },
        {
            "id": 661,
            "name": "Early May bank holiday (VE day)",
            "date": "2020-05-08",
            "start": "2020-05-07 23:00:00",
            "end": "2020-05-08 23:00:00",
            "public": true,
            "type": "public",
            "language": "EN",
            "country": "GB",
            "country_url": "/api/v1/countries/gb",
            "substitute": null,
            "note": ""
        },
        {
            "id": 662,
            "name": "Spring bank holiday",
            "date": "2020-05-25",
            "start": "2020-05-24 23:00:00",
            "end": "2020-05-25 23:00:00",
            "public": true,
            "type": "public",
            "language": "EN",
            "country": "GB",
            "country_url": "/api/v1/countries/gb",
            "substitute": null,
            "note": ""
        },
        {
            "id": 663,
            "name": "Christmas Day",
            "date": "2020-12-25",
            "start": "2020-12-25 00:00:00",
            "end": "2020-12-26 00:00:00",
            "public": true,
            "type": "public",
            "language": "EN",
            "country": "GB",
            "country_url": "/api/v1/countries/gb",
            "substitute": null,
            "note": ""
        },
        {
            "id": 664,
            "name": "Boxing Day",
            "date": "2020-12-26",
            "start": "2020-12-26 00:00:00",
            "end": "2020-12-27 00:00:00",
            "public": true,
            "type": "public",
            "language": "EN",
            "country": "GB",
            "country_url": "/api/v1/countries/gb",
            "substitute": null,
            "note": ""
        },
        {
            "id": 665,
            "name": "Boxing Day (substitute day)",
            "date": "2020-12-28",
            "start": "2020-12-28 00:00:00",
            "end": "2020-12-29 00:00:00",
            "public": true,
            "type": "public",
            "language": "EN",
            "country": "GB",
            "country_url": "/api/v1/countries/gb",
            "substitute": true,
            "note": ""
        }
    ]
}