Question 1

Is the Sri Lankan Holiday API & Node Module free to use?

Accepted Answer

Yes, the Sri Lankan Holiday API & Node Module (sri-lankan-holiday-api) is 100% free and open-source under the MIT license with zero API keys required.

Question 2

How do I install the Sri Lankan Holiday SDK in Node.js or TypeScript?

Accepted Answer

Run `npm install sri-lankan-holiday-api` or `pnpm add sri-lankan-holiday-api`. It is a zero-dependency, 100% offline-ready TypeScript library.

Question 3

How are Full Moon Poya Days calculated in the API?

Accepted Answer

Full Moon Poya days are astronomically calculated using the Jean Meeus lunar phase algorithm specifically calibrated for Sri Lanka Standard Time (Asia/Colombo timezone, UTC+5:30).

Question 4

What years are covered in the Sri Lanka Holiday API?

Accepted Answer

The API covers 22 complete calendar years from 2024 to 2045, containing over 858 cataloged holidays.

Question 5

How do I query upcoming holidays or check if today is a holiday in v3.2.0 API?

Accepted Answer

Use /api/v3/holidays/upcoming to get the next holiday with a countdown or /api/v3/holidays/today to check today status in Sri Lanka timezone.

Report an API Bug or Data Issue