Today's Holidays API

Endpoints

Below is a list of endpoints used to access the API.

GET All Holidays

https://todaysholidaysapi.com/holidays

This endpoint accepts no parameters and returns a list of all holidays for every month of the year.

Example

  • All Holidays: https://todaysholidaysapi.com/holidays

GET Holidays by Month

https://todaysholidaysapi.com/holidays/${month}

Replace month in the URL with the int month you would like holidays returned for.

Examples

  • March Holidays: https://todaysholidaysapi.com/holidays/3
  • October Holidays: https://todaysholidaysapi.com/holidays/10

GET Holidays by Month and Day

https://todaysholidaysapi.com/holidays/${month}/%{day}

Replace month and day in the URL with the int month and day you would like holidays returned for.

Samples

  • March 1st Holidays: https://todaysholidaysapi.com/holidays/3/1
  • October 26th Holidays: https://todaysholidaysapi.com/holidays/10/26

GET Search Holidays

https://todaysholidaysapi.com/holidays/search?s=${searchQuery}

Replace searchQuery and in the URL with the encodeURIComponent string you would like holidays searched for.

This returns all matching holidays throughout the year.

Samples

  • https://todaysholidaysapi.com/holidays/search?s=dog
  • https://todaysholidaysapi.com/holidays/search?s=video+game