# India Holidays API > Free, fast, reliable REST API providing Indian holiday datasets across 36 States and Union Territories with long weekend planning, iCalendar feeds, and business day calculations. - Docs & Web Explorer: https://holiday2api.vercel.app/ - OpenAPI Spec: https://holiday2api.vercel.app/api/openapi.json - Health Check: https://holiday2api.vercel.app/api/health ## Core Endpoints - GET https://holiday2api.vercel.app/api/holidays/{year}/{state} - Get all holidays for a given year (2024–2036) and 2-letter state code (e.g. TG, MH, KA, DL, IN). - GET https://holiday2api.vercel.app/api/holidays/upcoming?state={state}&limit=10 - Get upcoming holidays starting from current date in IST (Asia/Kolkata). - GET https://holiday2api.vercel.app/api/long-weekends/{year}/{state} - Automated 3-day and 4-day bridge long weekend vacation finder. - GET https://holiday2api.vercel.app/api/business-days?from=YYYY-MM-DD&to=YYYY-MM-DD&state={state}&bank_rules=true - Working and business days calculator. - GET https://holiday2api.vercel.app/api/calendar/{year}/{state}.ics - RFC 5545 iCalendar feed export for Google & Apple Calendar. - GET https://holiday2api.vercel.app/api/meta/states - List of all 36 supported States & UTs with ISO codes. - GET https://holiday2api.vercel.app/api/meta/types - List of holiday classifications (national, state, public, restricted).