Vaishnava calendar¶
Free · all plans
The Gaudiya (ISKCON) calendar at one place: Ekadashi at the local sunrise with the exact parana (fast-breaking) window, festivals, appearance and disappearance days, and periods such as Chaturmasya. All times carry the place's local offset.
GET /v1/vedic/vaishnava/calendar¶
Scope: charts:read.
| Query | Type | Required | Notes |
|---|---|---|---|
from_day |
date | yes | first civil day, inclusive |
to_day |
date | yes | last civil day, inclusive; at most 400 days after from_day |
latitude |
number | yes | −90…90 |
longitude |
number | yes | −180…180 |
timezone |
IANA name | no | leave it out and the zone of the coordinates is used (the safer choice) |
curl "https://api.astrolinkers.com/v1/vedic/vaishnava/calendar?from_day=2026-11-01&to_day=2026-11-30&latitude=28.61&longitude=77.21" \
-H "Authorization: Bearer $ASTROLINKERS_API_KEY"
Response: from_day, to_day, timezone (resolved), tradition ("gaudiya"),
method_version, and days[].
GET /v1/vedic/vaishnava/upcoming¶
Scope: charts:read. The next days after a given day that carry an Ekadashi or an observance.
| Query | Type | Required | Notes |
|---|---|---|---|
after |
date | yes | days strictly after this one |
latitude, longitude |
number | yes | as above |
timezone |
IANA name | no | as above |
count |
integer | no (5) | 1…40 |
within_days |
integer | no (400) | 1…400 |
Response: after, timezone, method_version, days[] (at most count).
A day¶
| Field | Meaning |
|---|---|
day, sunrise, sunset |
the civil day and its sunrise/sunset at the place |
masa, is_adhika_masa, gaurabda_year |
Vaishnava month (madhusudana … vishnu), leap month flag, Gaurabda year |
paksha, tithi |
shukla/krishna; the tithi at sunrise (the 15th reads amavasya in both halves — paksha tells them apart) |
ekadashi |
null, or {name, kind, fasting, mahadvadashi, parana} — kind: suddha_ekadashi, mahadvadashi, viddha_dvadashi |
observances[] |
{id, kind, fasting, parana} — kind: ekadashi, festival, appearance, disappearance, period |
periods[] |
{id, day_index, day_count, abstain} for days inside a period |
parana is {starts_at, ends_at, case}; ends_at: null means "break the fast after
starts_at". fasting is one of grains_and_beans, nirjala, until_noon,
until_sunset, until_moonrise, until_midnight, none.
| Status | error.code |
When |
|---|---|---|
422 |
invalid_range |
to_day before from_day. |
422 |
range_too_long |
More than 400 days. |
422 |
vaishnava_calendar_failed |
No sunrise at that latitude on a day, or an unknown timezone. |