Holid

API documentation for Holid API

All country codes are in ISO ALPHA-2 format

get
Fetch holidays

/v1/:countryCode
Fetches all holidays of the country represented by the string countryCode provided countryCode - string - REQUIRED - 2 letter code representing a country Timezone example: Africa/Nairobi Full list of time zone database names can be found here: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
Request
Response
Path Parameters
timezone
required
string
Time zone database name in which today's holiday is being queried.
200: OK
{
success: true,
holidays: [
{
date: '1 Jan',
name: 'New year'
},
{
date: '4 Mar',
name: 'Some Holiday'
},
...
]
}
//or
{
success: true,
holidays: [] // If no holidays found
}
404: Not Found
<Error message>

get
Check today's holiday, if any

http://api.holid.co/v1/:countryCode/today
Checks today's holiday (if any) in the country represented by the countryCode provided countryCode - string - REQUIRED - 2 letter string representing a country code (ISO-2)
Request
Response
Path Parameters
optional
string
200: OK
{
success: true,
holidays: [
{
date: '1 Jan', //Today's date
name: 'New Year\'s day'
}
]
}
//or
{
success: true,
holidays: [] //If no holidays found
}
404: Not Found
Country code not found

get
Check holiday on certain date

http://api.holid.co/v1/:countryCode/:date/:month
Checks if the date provided is a holiday in the country represented by the country code provided. countryCode - string - REQUIRED - 2 letter code representing a country. date - number - REQUIRED - a number representing the date/day of the month, starts from 1 month - number - REQUIRED - a number representing a month - 1 for January Note: For month, modulus of 12 is used, so if 13 is provided, it will interpret it to January etc.
Request
Response
Path Parameters
optional
string
200: OK
{
success: true,
holidays: [
{
date: '1 Jan', //Date queried
name: 'New Year\'s day'
}
]
}
//or
{
success: true,
holidays: [] //If no holidays are found
}
404: Not Found
Country code not found