API Release Notes & Version Updates

API Release Changelog

Track features, dataset updates, security enhancements, and version releases for the Sri Lankan Holiday API.

v3.0.0-Beta (API v2)Latest
August 03, 2026

Major release featuring 100% hand-researched Sri Lankan Government Gazette dataset, new API v2 endpoint suite with full-text search, pagination, multi-upcoming limit support, and dataset analytics.

Dataset

  • Replaced procedural formula calculations with 100% hand-researched official Sri Lankan Government Gazette holiday dates (2024–2030).
  • Verified exact August 27, 2026 Nikini Full Moon Poya Day date and Adhi Nikini Poya alignment.
  • Validated all Buddhist Poya days, Hindu Tamil festivals, Islamic lunar observances, and Christian holidays.

Features

  • Added GET /api/v2/holidays with search, multi-field filtering, sorting (date_asc, date_desc), and page-based pagination.
  • Added GET /api/v2/holidays/poya dedicated endpoint returning official Sri Lanka Full Moon Poya days.
  • Added GET /api/v2/holidays/next-poya endpoint returning the immediate next Poya day with live daysUntil countdown.
  • Added GET /api/v2/holidays/religion/[religion] filtering holidays by tradition (buddhist, hindu, islamic, christian, national).
  • Added GET /api/v2/holidays/upcoming with ?limit=N parameter supporting multi-upcoming holiday queries.
  • Added GET /api/v2/holidays/search for full-text keyword queries.
  • Added GET /api/v2/holidays/stats for dataset breakdown analytics and real-time telemetry.

Documentation

  • Updated /docs portal with v1 vs v2 API version tabs and live endpoint execution test buttons.
  • Created dedicated API Changelog page (/changelog) tracking version history.
v2.5.0Stable
August 02, 2026

Security hardening, Edge DDoS sliding-window rate limiting, custom Next.js docs portal, diagnostic health endpoint, and AI Vibe Coder system prompt.

Security

  • Implemented Edge Sliding-Window Rate Limiting (60 requests / min per IP) in middleware.ts.
  • Added strict HTTP security headers: HSTS, X-Frame-Options, X-Content-Type-Options, XSS-Protection, and CORS.

Features

  • Built native Next.js documentation portal at /docs replacing external swagger bundles.
  • Upgraded GET /api/v1/health returning detailed system uptime, memory usage, dataset metrics, and rate limit status.
  • Added Master AI System Prompt tab for developers using Cursor, ChatGPT, Claude, or Copilot.
v2.0.0Legacy
August 01, 2026

Extended multi-year dataset coverage to 2045 and added full dataset export tools in JSON and CSV formats.

Features

  • Added GET /api/v1/holidays/export endpoint supporting ?format=json and ?format=csv downloads.
  • Expanded holiday catalog from 2024 to 2045 (22 years coverage).
v1.0.0Legacy
July 25, 2026

Initial public launch of Sri Lankan Holiday REST API.

Features

  • Launched REST API endpoints for Sri Lankan public, bank, and Poya holidays.
  • Added filters by year, month, date, and holiday type.