Sri Lankan Holiday API Logo
Sri Lankan Holiday API
Release Candidate: API v2 & v3.0.0-Beta Endpoints Active

Next.js API Documentation Portal

Complete REST API specification & Node.js Module SDK documentation for 300+ Sri Lankan public, bank, and Poya holidays (2024–2035). Free, open-source, zero authentication required.

https://holiday.imrishmika.dev npm i sri-lankan-holiday-api Rate Limit: 60 req / min

Official Node.js Module (sri-lankan-holiday-api)v3.0.0

100% offline-ready TypeScript SDK with 28 helper methods for zero-latency local queries.

npm i sri-lankan-holiday-api
NPM Playground
GETAPI v2 / v3 Beta/api/v2/holidays

Advanced Holidays Query (v2 / v3 Beta)

API v2 / v3 Beta endpoint featuring full-text search, multi-field filtering, sorting (date_asc, date_desc, name_asc), Poya flag, and page-based pagination.

Example Request URL

https://holiday.imrishmika.dev/api/v2/holidays?search=poya&sort=date_asc&limit=10

Parameters Specification

ParameterTypeRequiredDescription
searchquery stringOptionalFull-text search keyword (matches name, description, date)
yearintegerOptionalFilter by year (2024 to 2045)
monthintegerOptionalFilter by month number (1 to 12)
typestringOptionalFilter by holiday type: buddhist, hindu, islamic, christian, national, international
isPoyabooleanOptionalSet to true to filter only Full Moon Poya days
sortstringOptionalSort direction: date_asc, date_desc, name_asc, name_desc. Default: date_asc
pageintegerOptionalPage number for pagination. Default: 1
limitintegerOptionalResults per page (1 to 200). Default: 50

Integration Code Generator

fetch("https://holiday.imrishmika.dev/api/v2/holidays?search=poya&sort=date_asc&limit=10")
  .then(res => res.json())
  .then(data => console.log(data));

Expected 200 OK Response Payload

{
  "success": true,
  "apiVersion": "3.0.0-beta",
  "pagination": {
    "total": 12,
    "page": 1,
    "limit": 10,
    "totalPages": 2,
    "hasNextPage": true,
    "hasPrevPage": false
  },
  "data": [
    {
      "id": "2026-01-03-duruthu-full-moon-poya-day",
      "name": "Duruthu Full Moon Poya Day",
      "date": "2026-01-03",
      "year": 2026,
      "month": 1,
      "day": 3,
      "dayOfWeek": "Saturday",
      "type": "buddhist",
      "category": "public_and_bank",
      "isPublicHoliday": true,
      "isBankHoliday": true
    }
  ],
  "meta": {
    "timezone": "Asia/Colombo",
    "filtersApplied": {
      "search": "poya",
      "sort": "date_asc"
    }
  }
}