---
title: "Hindu calendar: ICS feed of festivals and vrats"
method: GET
path: "/vedic/calendar/ics"
tags: ["Vedic"]
---

# Hindu calendar: ICS feed of festivals and vrats

`GET /vedic/calendar/ics`

## Request

- Base URL: `https://api.astroway.info/v1`
- URL: `https://api.astroway.info/v1/vedic/calendar/ics`
- Auth: API key in header `X-Api-Key`
- TypeScript: <https://skmtc.dev/astroway/apis/astroway-calculation-api/docs/vedic/calendar/ics/get.ts> (a function with typed inputs; its response is checked against the schema)

The festivals and vrats of a year for a place as an iCalendar file (`text/calendar`, RFC 5545): one all-day event per observance, the rule, tithi window, parana and source in the description, a stable UID per festival, date and place. Query: `year`, `latitude`, `longitude`, `timezone` (IANA or auto), `include` (festivals, vrats or single vrat types, comma separated; default festivals,vrats), `tradition`. The key travels in X-Api-Key, so fetch it from your server and serve the file to calendar apps; it is priced as one festivals call.

## Query parameters

- `year` integer, required
- `latitude` number, required
- `longitude` number, required
- `timezone` string
- `include` string
- `tradition` 'smarta' | 'vaishnava'
- `ayanamsaId` integer
- `fields` string
- `precision` integer

## Response `200`

iCalendar (RFC 5545): one all-day VEVENT per festival and vrat, the rule, tithi window, parana and source in DESCRIPTION.

## Other responses

- `400`: Validation error
- `401`: Missing or invalid API key

## Changes

- **2026-11-07** `69a55e116a5e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/astroway/apis/astroway-calculation-api/changes/vedic/calendar/ics/get.md)

---

[API](https://skmtc.dev/astroway/apis/astroway-calculation-api.md) - [All operations](https://skmtc.dev/astroway/apis/astroway-calculation-api/llms.txt) - [OpenAPI document](https://skmtc.dev/astroway/apis/astroway-calculation-api/revisions/bf266b2e6703?raw)