An open-source API to get Sri Lankan holidays and a list of Sri Lankan holidays in several file formats for easy integration with your applications. Holidays are updated every year and currently contains holidays starting from 2021.
| Project/App | Description |
|---|---|
| Simple-Calendar | A simple calendar with events, tasks, customizable colors, widgets and no ads. |
- Reliable and accurate local data (see Data Sources)
- Open-source and free to use
- Updated every year
- Available as both API and downloadable files
- Holiday categorizations (Public, Bank, Mercantile, Poya, etc.)
API is under development and will be available soon for public use.
If you want to use/try the current unstable version of the API, feel free to do so by forking the repository and running the API locally. API is built using FastAPI and dependencies can be installed using pip install -r requirements.txt within a virtual environment.
API Docs & testing features will be available at http://localhost:8000/docs and http://localhost:8000/redoc after running the API.
From here you can download the list of holidays in several file formats and integrate with your applications directly without using the API.
These files are generated automatically from the iCalendar files and are available in JSON, CSV, and XML formats.
All the data is collected from verified and reliable sources within the Sri Lankan government. This usually involves the Ministry of Home Affairs, Department of Government Printing and the Gazette papers.
- State Ministry of Home Affairs, Sri Lanka - https://moha.gov.lk/
- Department of Government Printing, Sri Lanka - http://www.documents.gov.lk/
Holidays are divided into several categories based on the default categorization method of the Sri Lankan government.
The following categories are used:
- Public Holidays - Holidays that are celebrated by the general public including poya days.
- Bank Holidays
- Mercantile Holidays
Got an idea? Found a bug? Feel free to open an issue or submit a pull request.
Fork the repository, make your changes and submit a pull request. It's that much easy! If you're not sure how to do that, here's a guide.
The MIT License
This program is free software: you can redistribute it and/or modify it under the terms of the MIT License. See the LICENSE file for more details. Attribution is required by leaving the author name and license info intact.