# Hindu calendar: ICS feed of festivals and vrats

`GET https://api.astroway.info/v1/vedic/calendar/ics`

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.

Group: Vedic. Auth: `X-Api-Key` header. Operation ID: `vedic_calendar_ics_get`.

## Parameters

| Name | In | Required | Type | Description |
|---|---|---|---|---|
| `year` | query | yes | integer | Gregorian year; events are those dated in it. |
| `latitude` | query | yes | number | Latitude in decimal degrees, north positive. |
| `longitude` | query | yes | number | Longitude in decimal degrees, east positive. |
| `timezone` | query | no | string | IANA zone name, or auto to look it up from the coordinates. Followed day by day, summer time included. |
| `include` | query | no | string | Comma list: festivals, vrats, or single vrat types (ekadashi, pradosh, sankashti, purnima, amavasya, masik-shivaratri). |
| `tradition` | query | no | "smarta" \| "vaishnava" | Whose reckoning decides the day where traditions differ (Rama Navami, Janmashtami). |
| `ayanamsaId` | query | no | integer | Ayanamsa id; 1 is Lahiri. |
| `fields` | query | no | string | Comma-separated dotted paths, relative to `data`, to keep in the response. A path is applied to every element of an array, so `planets.name` means the name of each planet. Paths that match nothing come back in `_fields_unmatched`; a list where nothing matches at all is a 400, because an empty object would be a confident wrong answer. |
| `precision` | query | no | integer | Round every non-integer number in the response to this many decimal places. Integers are left alone, because an id is not a measurement. Ecliptic longitudes ship with fourteen decimals by default; 2 is about a tenth of an arcminute. |

## Responses

| Status | Meaning |
|---|---|
| 200 | iCalendar (RFC 5545): one all-day VEVENT per festival and vrat, the rule, tithi window, parana and source in DESCRIPTION. |
| 400 | Validation error |
| 401 | Missing or invalid API key |

## Example

```bash
curl -X GET https://api.astroway.info/v1/vedic/calendar/ics?year=2026&latitude=28.6139&longitude=77.209 \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json"
```

---

Rendered from https://api.astroway.info/v1/openapi.json. HTML page: https://api.astroway.info/docs/api/operations/vedic_calendar_ics_get/