National Holidays API

This API returns a list of National holidays in JSON format. The data provided by Google Calendar and automatically parsed from iCAL format to JSON format. Data for last year, this year, and next year is available. Yearly data will be stored separately by directory.

API URLs

{server}/api/v1/holidays/{country-code}
{server}/api/v1/holidays/{country-code}/{year}

Example data

National holidays basic API (date format only)

https://pine1611.github.io/holidays/api/v1/vn/date.json

{
    "2025-04-30": "Liberation Day/Reunification Day",
    "2025-05-01": "International Labor Day",
    "2025-05-02": "International Labor Day Holiday",
}

Returns an object containing the names of holidays using the date as a key.

Yearly API (date format only)

To ensure clear organization and efficient access, yearly data will be stored separately in its own directory. For specify the year, it would be similar to the basic API just add the year after it.

https://pine1611.github.io/holidays/api/v1/vn/2025/date.json

In the above URL 2025, specify the year in four digits. Returns only the data for the specified year. The return format is the same as the basic API (date format only).

License

MIT