Calendar

Tithi start and end moments, every Ekadashi of a year with its paran window, and the festivals, each by its stated rule.

Tithi start and end moments between two dates, and the tithi at each sunrise

GET/v1/calendar/tithis

1 credit · Secret or publishable key · getTithis

from and to are local dates at the place, at most 62 days apart (inclusive). tithis: every tithi overlapping those days, to the minute (the instants do not depend on the place). sunrise_tithis: the tithi at each local sunrise (upper limb, refracted), the one a day is named after. Where the Sun does not rise on one of the days (polar latitudes) the request is refused.

Parameters

NameInTypeNotes
from requiredquerystring (date) e.g. "1990-08-13"
to requiredquerystring (date) e.g. "1990-08-13"
lat requiredquerynumber ≥ -90 · ≤ 90
lon requiredquerynumber ≥ -180 · ≤ 180

Response

JSON { data, meta, warnings }, where data is:

  • from string (date) required

    e.g. "1990-08-13"

  • to string (date) required

    e.g. "1990-08-13"

  • tithis array of object required
    • number integer required

      ≥ 1 · ≤ 30

    • id string required
    • paksha string required

      one of shukla, krishna

    • start string (date-time) required
    • end string (date-time) required
  • sunrise_tithis array of object required
    • date string (date) required

      e.g. "1990-08-13"

    • sunrise string (date-time) required
    • tithi object required
      Fields
      • number integer required

        ≥ 1 · ≤ 30

      • id string required
      • paksha string required

        one of shukla, krishna

Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.

Example request

curl 'https://api.astrologics.in/v1/calendar/tithis?from=2026-11-16&to=2026-11-22&lat=28.6139&lon=77.209' \
  -H 'Authorization: Bearer al_test_YOUR_KEY'
Node.js
const res = await fetch("https://api.astrologics.in/v1/calendar/tithis?from=2026-11-16&to=2026-11-22&lat=28.6139&lon=77.209", {
  headers: { Authorization: "Bearer al_test_YOUR_KEY" },
});
console.log(JSON.stringify(await res.json(), null, 2));
Python
import json
import urllib.error
import urllib.request

req = urllib.request.Request(
    "https://api.astrologics.in/v1/calendar/tithis?from=2026-11-16&to=2026-11-22&lat=28.6139&lon=77.209",
    method="GET",
    headers={"Authorization": "Bearer al_test_YOUR_KEY"},
)
try:
    with urllib.request.urlopen(req) as res:
        print(json.dumps(json.load(res), indent=2, ensure_ascii=False))
except urllib.error.HTTPError as err:
    print(err.code, err.read().decode())
PHP
<?php
$ch = curl_init('https://api.astrologics.in/v1/calendar/tithis?from=2026-11-16&to=2026-11-22&lat=28.6139&lon=77.209');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY'],
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 3,145 characters
{
  "data": {
    "from": "2026-11-16",
    "to": "2026-11-22",
    "tithis": [
      {
        "number": 6,
        "id": "shashthi",
        "paksha": "shukla",
        "start": "2026-11-14T17:55:00.000Z",
        "end": "2026-11-15T20:32:00.000Z"
      },
      {
        "number": 7,
        "id": "saptami",
        "paksha": "shukla",
        "start": "2026-11-15T20:32:00.000Z",
        "end": "2026-11-16T22:51:00.000Z"
      },
      {
        "number": 8,
        "id": "ashtami",
        "paksha": "shukla",
        "start": "2026-11-16T22:51:00.000Z",
        "end": "2026-11-18T00:36:00.000Z"
      },
      {
        "number": 9,
        "id": "navami",
        "paksha": "shukla",
        "start": "2026-11-18T00:36:00.000Z",
        "end": "2026-11-19T01:37:00.000Z"
      },
      {
        "number": 10,
        "id": "dashami",
        "paksha": "shukla",
        "start": "2026-11-19T01:37:00.000Z",
        "end": "2026-11-20T01:47:00.000Z"
      },
      {
        "number": 11,
        "id": "ekadashi",
        "paksha": "shukla",
        "start": "2026-11-20T01:47:00.000Z",
        "end": "2026-11-21T01:02:00.000Z"
      },
      {
        "number": 12,
        "id": "dwadashi",
        "paksha": "shukla",
        "start": "2026-11-21T01:02:00.000Z",
        "end": "2026-11-21T23:27:00.000Z"
      },
      {
        "number": 13,
        "id": "trayodashi",
        "paksha": "shukla",
        "start": "2026-11-21T23:27:00.000Z",
        "end": "2026-11-22T21:08:00.000Z"
      }
    ],
    "sunrise_tithis": [
      {
        "date": "2026-11-16",
        "sunrise": "2026-11-16T01:14:00.000Z",
        "tithi": {
          "number": 7,
          "id": "saptami",
          "paksha": "shukla"
        }
      },
      {
        "date": "2026-11-17",
        "sunrise": "2026-11-17T01:15:00.000Z",
        "tithi": {
          "number": 8,
          "id": "ashtami",
          "paksha": "shukla"
        }
      },
      {
        "date": "2026-11-18",
        "sunrise": "2026-11-18T01:16:00.000Z",
        "tithi": {
          "number": 9,
          "id": "navami",
          "paksha": "shukla"
        }
      },
      {
        "date": "2026-11-19",
        "sunrise": "2026-11-19T01:17:00.000Z",
        "tithi": {
          "number": 9,
          "id": "navami",
          "paksha": "shukla"
        }
      },
      {
        "date": "2026-11-20",
        "sunrise": "2026-11-20T01:18:00.000Z",
        "tithi": {
          "number": 10,
          "id": "dashami",
          "paksha": "shukla"
        }
      },
      {
        "date": "2026-11-21",
        "sunrise": "2026-11-21T01:18:00.000Z",
        "tithi": {
          "number": 12,
          "id": "dwadashi",
          "paksha": "shukla"
        }
      },
      {
        "date": "2026-11-22",
        "sunrise": "2026-11-22T01:19:00.000Z",
        "tithi": {
          "number": 13,
          "id": "trayodashi",
          "paksha": "shukla"
        }
      }
    ]
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.9.28",
    "mode": "live",
    "credits_charged": 1
  },
  "warnings": []
}
Try it

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one

Every Ekadashi of a year: the vrat date, the tithi and the paran window

GET/v1/calendar/ekadashi

1 credit · Secret or publishable key · getEkadashis

date: the local day whose sunrise the Ekadashi tithi covers (Smarta); if it covers no sunrise, the day it begins (flag covers_neither_sunrise); if it covers two, the first (flag covers_both_sunrises). paran is our own rule, labelled rule_by astrologics: from the later of sunrise on the next day and the end of Hari Vasara (the first quarter of Dwadashi), to the end of Dwadashi. vaishnava.date appears only where the Vaishnava rule (Dashami at arunodaya, 96 minutes before sunrise) moves the fast to the next day; its paran is not computed. month: amanta, with the purnimanta name alongside. Refused where the Sun does not rise on every day of the year.

Parameters

NameInTypeNotes
year requiredqueryinteger ≥ 1900 · ≤ 2100
lat requiredquerynumber ≥ -90 · ≤ 90
lon requiredquerynumber ≥ -180 · ≤ 180

Response

JSON { data, meta, warnings }, where data is:

  • year integer required
  • ekadashis array of object required
    • id string required
    • name string required
    • name_hi string required
    • month object required
      Fields
      • amanta string required
      • purnimanta string required
      • adhik boolean required
    • paksha string required

      one of shukla, krishna

    • date string (date) required

      e.g. "1990-08-13"

    • tithi TimeWindow required
      Fields
      • start string (date-time) required
      • end string (date-time) required
    • paran object required
      Fields
      • start string (date-time) required
      • end string (date-time) required
      • rule_by "astrologics" required
    • vaishnava object or null required

      One of:

      1. object
        Fields
        • date string (date) required

          e.g. "1990-08-13"

      2. null
    • flags array of string required

Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.

Example request

curl 'https://api.astrologics.in/v1/calendar/ekadashi?year=2026&lat=28.6139&lon=77.209' \
  -H 'Authorization: Bearer al_test_YOUR_KEY'
Node.js
const res = await fetch("https://api.astrologics.in/v1/calendar/ekadashi?year=2026&lat=28.6139&lon=77.209", {
  headers: { Authorization: "Bearer al_test_YOUR_KEY" },
});
console.log(JSON.stringify(await res.json(), null, 2));
Python
import json
import urllib.error
import urllib.request

req = urllib.request.Request(
    "https://api.astrologics.in/v1/calendar/ekadashi?year=2026&lat=28.6139&lon=77.209",
    method="GET",
    headers={"Authorization": "Bearer al_test_YOUR_KEY"},
)
try:
    with urllib.request.urlopen(req) as res:
        print(json.dumps(json.load(res), indent=2, ensure_ascii=False))
except urllib.error.HTTPError as err:
    print(err.code, err.read().decode())
PHP
<?php
$ch = curl_init('https://api.astrologics.in/v1/calendar/ekadashi?year=2026&lat=28.6139&lon=77.209');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY'],
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 15,388 characters
{
  "data": {
    "year": 2026,
    "ekadashis": [
      {
        "id": "shattila",
        "name": "Shattila Ekadashi",
        "name_hi": "षटतिला एकादशी",
        "month": {
          "amanta": "pausha",
          "purnimanta": "magha",
          "adhik": false
        },
        "paksha": "krishna",
        "date": "2026-01-14",
        "tithi": {
          "start": "2026-01-13T09:49:00.000Z",
          "end": "2026-01-14T12:24:00.000Z"
        },
        "paran": {
          "start": "2026-01-15T01:45:00.000Z",
          "end": "2026-01-15T14:47:00.000Z",
          "rule_by": "astrologics"
        },
        "vaishnava": null,
        "flags": []
      },
      {
        "id": "jaya",
        "name": "Jaya Ekadashi",
        "name_hi": "जया एकादशी",
        "month": {
          "amanta": "magha",
          "purnimanta": "magha",
          "adhik": false
        },
        "paksha": "shukla",
        "date": "2026-01-29",
        "tithi": {
          "start": "2026-01-28T11:07:00.000Z",
          "end": "2026-01-29T08:26:00.000Z"
        },
        "paran": {
          "start": "2026-01-30T01:40:00.000Z",
          "end": "2026-01-30T05:40:00.000Z",
          "rule_by": "astrologics"
        },
        "vaishnava": null,
        "flags": []
      },
      {
        "id": "vijaya",
        "name": "Vijaya Ekadashi",
        "name_hi": "विजया एकादशी",
        "month": {
          "amanta": "magha",
          "purnimanta": "phalguna",
          "adhik": false
        },
        "paksha": "krishna",
        "date": "2026-02-13",
        "tithi": {
          "start": "2026-02-12T06:53:00.000Z",
          "end": "2026-02-13T08:57:00.000Z"
        },
        "paran": {
          "start": "2026-02-14T01:30:00.000Z",
          "end": "2026-02-14T10:33:00.000Z",
          "rule_by": "astrologics"
        },
        "vaishnava": null,
        "flags": []
      },
      {
        "id": "amalaki",
        "name": "Amalaki Ekadashi",
        "name_hi": "आमलकी एकादशी",
        "month": {
          "amanta": "phalguna",
          "purnimanta": "phalguna",
          "adhik": false
        },
        "paksha": "shukla",
        "date": "2026-02-27",
        "tithi": {
          "start": "2026-02-26T19:04:00.000Z",
          "end": "2026-02-27T17:04:00.000Z"
        },
        "paran": {
          "start": "2026-02-28T01:18:00.000Z",
          "end": "2026-02-28T15:14:00.000Z",
          "rule_by": "astrologics"
        },
        "vaishnava": null,
        "flags": []
      },
      {
        "id": "papmochani",
        "name": "Papmochani Ekadashi",
        "name_hi": "पापमोचनी एकादशी",
        "month": {
          "amanta": "phalguna",
          "purnimanta": "chaitra",
          "adhik": false
        },
        "paksha": "krishna",
        "date": "2026-03-15",
        "tithi": {
          "start": "2026-03-14T02:42:00.000Z",
          "end": "2026-03-15T03:47:00.000Z"
        },
        "paran": {
          "start": "2026-03-16T01:00:00.000Z",
          "end": "2026-03-16T04:12:00.000Z",
          "rule_by": "astrologics"
        },
        "vaishnava": null,
        "flags": []
      },
      {
        "id": "kamada",
        "name": "Kamada Ekadashi",
        "name_hi": "कामदा एकादशी",
        "month": {
          "amanta": "chaitra",
          "purnimanta": "chaitra",
          "adhik": false
        },
        "paksha": "shukla",
        "date": "2026-03-29",
        "tithi": {
          "start": "2026-03-28T03:17:00.000Z",
          "end": "2026-03-29T02:17:00.000Z"
        },
        "paran": {
          "start": "2026-03-30T00:44:00.000Z",
          "end": "2026-03-30T01:41:00.000Z",
          "rule_by": "astrologics"
        },
        "vaishnava": null,
        "flags": []
      },
      {
        "id": "varuthini",
        "name": "Varuthini Ekadashi",
        "name_hi": "वरूथिनी एकादशी",
        "month": {
          "amanta": "chaitra",
          "purnimanta": "vaishakha",
          "adhik": false
        },
        "paksha": "krishna",
        "date": "2026-04-13",
        "tithi": {
          "start": "2026-04-12T19:48:00.000Z",
          "end": "2026-04-13T19:40:00.000Z"
        },
        "paran": {
          "start": "2026-04-14T01:25:45.000Z",
          "end": "2026-04-14T18:43:00.000Z",
          "rule_by": "astrologics"
        },
        "vaishnava": null,
        "flags": []
      },
      {
        "id": "mohini",
        "name": "Mohini Ekadashi",
        "name_hi": "मोहिनी एकादशी",
        "month": {
          "amanta": "vaishakha",
          "purnimanta": "vaishakha",
          "adhik": false
        },
        "paksha": "shukla",
        "date": "2026-04-27",
        "tithi": {
          "start": "2026-04-26T12:38:00.000Z",
          "end": "2026-04-27T12:47:00.000Z"
        },
        "paran": {
          "start": "2026-04-28T00:13:00.000Z",
          "end": "2026-04-28T13:23:00.000Z",
          "rule_by": "astrologics"
        },
        "vaishnava": null,
        "flags": []
      },
      {
        "id": "apara",
        "name": "Apara Ekadashi",
        "name_hi": "अपरा एकादशी",
        "month": {
          "amanta": "vaishakha",
          "purnimanta": "jyeshtha",
          "adhik": false
        },
        "paksha": "krishna",
        "date": "2026-05-13",
        "tithi": {
          "start": "2026-05-12T09:23:00.000Z",
          "end": "2026-05-13T08:01:00.000Z"
        },
        "paran": {
          "start": "2026-05-14T00:01:00.000Z",
          "end": "2026-05-14T05:51:00.000Z",
          "rule_by": "astrologics"
        },
        "vaishnava": null,
        "flags": []
      },
      {
        "id": "padmini",
        "name": "Padmini Ekadashi",
        "name_hi": "पद्मिनी एकादशी",
        "month": {
          "amanta": "jyeshtha",
          "purnimanta": "jyeshtha",
          "adhik": true
        },
        "paksha": "shukla",
        "date": "2026-05-26",
        "tithi": {
          "start": "2026-05-25T23:42:00.000Z",
          "end": "2026-05-27T00:53:00.000Z"
        },
        "paran": {
          "start": "2026-05-27T07:16:45.000Z",
          "end": "2026-05-28T02:28:00.000Z",
          "rule_by": "astrologics"
        },
        "vaishnava": {
          "date": "2026-05-27"
        },
        "flags": [
          "covers_both_sunrises"
        ]
      },
      {
        "id": "parama",
        "name": "Parama Ekadashi",
        "name_hi": "परमा एकादशी",
        "month": {
          "amanta": "jyeshtha",
          "purnimanta": "jyeshtha",
          "adhik": true
        },
        "paksha": "krishna",
        "date": "2026-06-11",
        "tithi": {
          "start": "2026-06-10T19:29:00.000Z",
          "end": "2026-06-11T17:07:00.000Z"
        },
        "paran": {
          "start": "2026-06-11T23:53:00.000Z",
          "end": "2026-06-12T14:08:00.000Z",
          "rule_by": "astrologics"
        },
        "vaishnava": null,
        "flags": []
      },
      {
        "id": "nirjala",
        "name": "Nirjala Ekadashi",
        "name_hi": "निर्जला एकादशी",
        "month": {
          "amanta": "jyeshtha",
          "purnimanta": "jyeshtha",
          "adhik": false
        },
        "paksha": "shukla",
        "date": "2026-06-25",
        "tithi": {
          "start": "2026-06-24T12:43:00.000Z",
          "end": "2026-06-25T14:40:00.000Z"
        },
        "paran": {
          "start": "2026-06-25T23:55:00.000Z",
          "end": "2026-06-26T16:53:00.000Z",
          "rule_by": "astrologics"
        },
        "vaishnava": null,
        "flags": []
      },
      {
        "id": "yogini",
        "name": "Yogini Ekadashi",
        "name_hi": "योगिनी एकादशी",
        "month": {
          "amanta": "jyeshtha",
          "purnimanta": "ashadha",
          "adhik": false
        },
        "paksha": "krishna",
        "date": "2026-07-10",
        "tithi": {
          "start": "2026-07-10T02:47:00.000Z",
          "end": "2026-07-10T23:54:00.000Z"
        },
        "paran": {
          "start": "2026-07-11T05:04:15.000Z",
          "end": "2026-07-11T20:35:00.000Z",
          "rule_by": "astrologics"
        },
        "vaishnava": {
          "date": "2026-07-11"
        },
        "flags": [
          "covers_neither_sunrise"
        ]
      },
      {
        "id": "devshayani",
        "name": "Devshayani Ekadashi",
        "name_hi": "देवशयनी एकादशी",
        "month": {
          "amanta": "ashadha",
          "purnimanta": "ashadha",
          "adhik": false
        },
        "paksha": "shukla",
        "date": "2026-07-25",
        "tithi": {
          "start": "2026-07-24T03:44:00.000Z",
          "end": "2026-07-25T06:05:00.000Z"
        },
        "paran": {
          "start": "2026-07-26T00:09:00.000Z",
          "end": "2026-07-26T08:29:00.000Z",
          "rule_by": "astrologics"
        },
        "vaishnava": null,
        "flags": []
      },
      {
        "id": "kamika",
        "name": "Kamika Ekadashi",
        "name_hi": "कामिका एकादशी",
        "month": {
          "amanta": "ashadha",
          "purnimanta": "shravana",
          "adhik": false
        },
        "paksha": "krishna",
        "date": "2026-08-09",
        "tithi": {
          "start": "2026-08-08T08:30:00.000Z",
          "end": "2026-08-09T05:36:00.000Z"
        },
        "paran": {
          "start": "2026-08-10T00:18:00.000Z",
          "end": "2026-08-10T02:32:00.000Z",
          "rule_by": "astrologics"
        },
        "vaishnava": null,
        "flags": []
      },
      {
        "id": "shravana_putrada",
        "name": "Shravana Putrada Ekadashi",
        "name_hi": "श्रावण पुत्रदा एकादशी",
        "month": {
          "amanta": "shravana",
          "purnimanta": "shravana",
          "adhik": false
        },
        "paksha": "shukla",
        "date": "2026-08-23",
        "tithi": {
          "start": "2026-08-22T20:31:00.000Z",
          "end": "2026-08-23T22:50:00.000Z"
        },
        "paran": {
          "start": "2026-08-24T05:20:30.000Z",
          "end": "2026-08-25T00:52:00.000Z",
          "rule_by": "astrologics"
        },
        "vaishnava": null,
        "flags": []
      },
      {
        "id": "aja",
        "name": "Aja Ekadashi",
        "name_hi": "अजा एकादशी",
        "month": {
          "amanta": "shravana",
          "purnimanta": "bhadrapada",
          "adhik": false
        },
        "paksha": "krishna",
        "date": "2026-09-07",
        "tithi": {
          "start": "2026-09-06T14:00:00.000Z",
          "end": "2026-09-07T11:35:00.000Z"
        },
        "paran": {
          "start": "2026-09-08T00:33:00.000Z",
          "end": "2026-09-08T09:14:00.000Z",
          "rule_by": "astrologics"
        },
        "vaishnava": null,
        "flags": []
      },
      {
        "id": "parivartini",
        "name": "Parivartini Ekadashi",
        "name_hi": "परिवर्तिनी एकादशी",
        "month": {
          "amanta": "bhadrapada",
          "purnimanta": "bhadrapada",
          "adhik": false
        },
        "paksha": "shukla",
        "date": "2026-09-22",
        "tithi": {
          "start": "2026-09-21T14:32:00.000Z",
          "end": "2026-09-22T16:14:00.000Z"
        },
        "paran": {
          "start": "2026-09-23T00:40:00.000Z",
          "end": "2026-09-23T17:21:00.000Z",
          "rule_by": "astrologics"
        },
        "vaishnava": null,
        "flags": []
      },
      {
        "id": "indira",
        "name": "Indira Ekadashi",
        "name_hi": "इन्दिरा एकादशी",
        "month": {
          "amanta": "bhadrapada",
          "purnimanta": "ashwin",
          "adhik": false
        },
        "paksha": "krishna",
        "date": "2026-10-06",
        "tithi": {
          "start": "2026-10-05T20:38:00.000Z",
          "end": "2026-10-06T19:05:00.000Z"
        },
        "paran": {
          "start": "2026-10-07T00:47:00.000Z",
          "end": "2026-10-07T17:47:00.000Z",
          "rule_by": "astrologics"
        },
        "vaishnava": null,
        "flags": []
      },
      {
        "id": "papankusha",
        "name": "Papankusha Ekadashi",
        "name_hi": "पापांकुशा एकादशी",
        "month": {
          "amanta": "ashwin",
          "purnimanta": "ashwin",
          "adhik": false
        },
        "paksha": "shukla",
        "date": "2026-10-22",
        "tithi": {
          "start": "2026-10-21T08:43:00.000Z",
          "end": "2026-10-22T09:19:00.000Z"
        },
        "paran": {
          "start": "2026-10-23T00:57:00.000Z",
          "end": "2026-10-23T09:07:00.000Z",
          "rule_by": "astrologics"
        },
        "vaishnava": null,
        "flags": []
      },
      {
        "id": "rama",
        "name": "Rama Ekadashi",
        "name_hi": "रमा एकादशी",
        "month": {
          "amanta": "ashwin",
          "purnimanta": "kartika",
          "adhik": false
        },
        "paksha": "krishna",
        "date": "2026-11-05",
        "tithi": {
          "start": "2026-11-04T05:34:00.000Z",
          "end": "2026-11-05T05:07:00.000Z"
        },
        "paran": {
          "start": "2026-11-06T01:07:00.000Z",
          "end": "2026-11-06T05:01:00.000Z",
          "rule_by": "astrologics"
        },
        "vaishnava": null,
        "flags": []
      },
      {
        "id": "devutthana",
        "name": "Devutthana Ekadashi",
        "name_hi": "देवउठनी एकादशी",
        "month": {
          "amanta": "kartika",
          "purnimanta": "kartika",
          "adhik": false
        },
        "paksha": "shukla",
        "date": "2026-11-20",
        "tithi": {
          "start": "2026-11-20T01:47:00.000Z",
          "end": "2026-11-21T01:02:00.000Z"
        },
        "paran": {
          "start": "2026-11-21T06:38:15.000Z",
          "end": "2026-11-21T23:27:00.000Z",
          "rule_by": "astrologics"
        },
        "vaishnava": {
          "date": "2026-11-21"
        },
        "flags": [
          "covers_neither_sunrise"
        ]
      },
      {
        "id": "utpanna",
        "name": "Utpanna Ekadashi",
        "name_hi": "उत्पन्ना एकादशी",
        "month": {
          "amanta": "kartika",
          "purnimanta": "margashirsha",
          "adhik": false
        },
        "paksha": "krishna",
        "date": "2026-12-04",
        "tithi": {
          "start": "2026-12-03T17:34:00.000Z",
          "end": "2026-12-04T18:16:00.000Z"
        },
        "paran": {
          "start": "2026-12-05T01:29:00.000Z",
          "end": "2026-12-05T19:23:00.000Z",
          "rule_by": "astrologics"
        },
        "vaishnava": null,
        "flags": []
      },
      {
        "id": "mokshada",
        "name": "Mokshada Ekadashi",
        "name_hi": "मोक्षदा एकादशी",
        "month": {
          "amanta": "margashirsha",
          "purnimanta": "margashirsha",
          "adhik": false
        },
        "paksha": "shukla",
        "date": "2026-12-20",
        "tithi": {
          "start": "2026-12-19T16:40:00.000Z",
          "end": "2026-12-20T14:45:00.000Z"
        },
        "paran": {
          "start": "2026-12-21T01:39:00.000Z",
          "end": "2026-12-21T12:07:00.000Z",
          "rule_by": "astrologics"
        },
        "vaishnava": null,
        "flags": []
      }
    ]
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.9.28",
    "mode": "live",
    "credits_charged": 1
  },
  "warnings": []
}
Try it

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one

Festivals of a year, each by its own rule, with its windows and moments

GET/v1/calendar/festivals

2 credits · Secret or publishable key · getFestivals

The rules of the 2026 festival season on astrologics.in, cross-checked there against published panchangs, for any year and place: Pitru Paksha (16 shraddhas, Maha Bharani, Magha), Sharad Navratri, Sandhi Puja, Vijayadashami, Sharad Purnima, Valmiki Jayanti, Karwa Chauth, Ahoi Ashtami, the Diwali week and Kartik. With them: Makar Sankranti (the Sun's sidereal entry into Makara; the next day if after sunset), Maha Shivaratri (Chaturdashi at nishita), Rama Navami (Navami at Madhyahna; Vaishnava: at sunrise), Raksha Bandhan (Purnima after Bhadra: Aparahna, else pradosh, else the next morning), Krishna Janmashtami (Ashtami at nishita, Smarta), Ganesh Chaturthi (Chaturthi at Madhyahna) and Holika Dahan (Drik Panchang's Bhadra rules: the pradosh after Bhadra, else after Bhadra until midnight, else the Punchha, else the next day's pradosh when Purnima lasts 3.5 prahars into it, else the pradosh outside Bhadra Mukha; Holi the next day), each served only after its 2026 date was cross-checked against two published sources (Drik Panchang, Prokerala, the Government of India holiday lists). Each observance is found in its nija lunar month (an adhik month is skipped) on the first local day that meets its rule. Where no day does (abroad, rarely in India), a fallback applies and flags names the unmet condition: sunset rules → the day whose pradosh the tithi overlaps most; Karwa Chauth → the day whose sunrise the Chaturthi holds; Sharad Purnima → the night whose nishita the Purnima covers most; otherwise the day the tithi begins. Magha and Maha Bharani shraddha appear only when the nakshatra touches an Aparahna of Pitru Paksha. windows are spans (Aparahna, pradosh, Lakshmi Puja …); moments are instants (moonrise: the Moon's centre on the true horizon; star_sighting: civil dusk). verified is true for the years in verified_years, whose dates were cross-checked at verified_place; other years and places follow the same rules. Refused where the Sun does not rise and set on the days these festivals need.

Parameters

NameInTypeNotes
year requiredqueryinteger ≥ 1900 · ≤ 2100
lat requiredquerynumber ≥ -90 · ≤ 90
lon requiredquerynumber ≥ -180 · ≤ 180

Response

JSON { data, meta, warnings }, where data is:

  • year integer required
  • verified_years array of integer required
  • verified_place object required
    • name string required
    • latitude number required
    • longitude number required
  • festivals array of object required
    • id string required
    • name string required
    • name_hi string required
    • date string (date) required

      e.g. "1990-08-13"

    • rule string required
    • tithi object required
      Fields
      • number integer required

        ≥ 1 · ≤ 30

      • id string required
      • paksha string required

        one of shukla, krishna

      • start string (date-time) required
      • end string (date-time) required
    • windows array of object required
      Fields
      • id string required
      • start string (date-time) required
      • end string (date-time) required
    • moments array of object required
      Fields
      • id string required
      • at string (date-time) required
    • vaishnava object or null required

      One of:

      1. object
        Fields
        • date string (date) required

          e.g. "1990-08-13"

      2. null
    • verified boolean required
    • flags array of string required

Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.

Example request

curl 'https://api.astrologics.in/v1/calendar/festivals?year=2026&lat=28.6139&lon=77.209' \
  -H 'Authorization: Bearer al_test_YOUR_KEY'
Node.js
const res = await fetch("https://api.astrologics.in/v1/calendar/festivals?year=2026&lat=28.6139&lon=77.209", {
  headers: { Authorization: "Bearer al_test_YOUR_KEY" },
});
console.log(JSON.stringify(await res.json(), null, 2));
Python
import json
import urllib.error
import urllib.request

req = urllib.request.Request(
    "https://api.astrologics.in/v1/calendar/festivals?year=2026&lat=28.6139&lon=77.209",
    method="GET",
    headers={"Authorization": "Bearer al_test_YOUR_KEY"},
)
try:
    with urllib.request.urlopen(req) as res:
        print(json.dumps(json.load(res), indent=2, ensure_ascii=False))
except urllib.error.HTTPError as err:
    print(err.code, err.read().decode())
PHP
<?php
$ch = curl_init('https://api.astrologics.in/v1/calendar/festivals?year=2026&lat=28.6139&lon=77.209');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY'],
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 41,775 characters
{
  "data": {
    "year": 2026,
    "verified_years": [
      2026
    ],
    "verified_place": {
      "name": "Delhi",
      "latitude": 28.6139,
      "longitude": 77.209
    },
    "festivals": [
      {
        "id": "makar_sankranti",
        "name": "Makar Sankranti",
        "name_hi": "मकर संक्रांति",
        "date": "2026-01-14",
        "rule": "the day of the Sun's sidereal entry into Makara, or the next day if it enters after sunset; punya kaal from a daytime entry to sunset",
        "tithi": {
          "number": 26,
          "id": "ekadashi",
          "paksha": "krishna",
          "start": "2026-01-13T09:49:00.000Z",
          "end": "2026-01-14T12:24:00.000Z"
        },
        "windows": [
          {
            "id": "punya_kaal",
            "start": "2026-01-14T09:35:00.000Z",
            "end": "2026-01-14T12:15:00.000Z"
          }
        ],
        "moments": [
          {
            "id": "sankranti",
            "at": "2026-01-14T09:35:00.000Z"
          }
        ],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "maha_shivaratri",
        "name": "Maha Shivaratri",
        "name_hi": "महाशिवरात्रि",
        "date": "2026-02-15",
        "rule": "the night whose nishita (the 8th night-muhurta) Magha Krishna Chaturdashi covers most",
        "tithi": {
          "number": 29,
          "id": "chaturdashi",
          "paksha": "krishna",
          "start": "2026-02-15T11:36:00.000Z",
          "end": "2026-02-16T12:05:00.000Z"
        },
        "windows": [
          {
            "id": "nishita",
            "start": "2026-02-15T18:39:24.000Z",
            "end": "2026-02-15T19:30:36.000Z"
          }
        ],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "holika_dahan",
        "name": "Holika Dahan",
        "name_hi": "होलिका दहन",
        "date": "2026-03-03",
        "rule": "Phalguna Purnima: the next day's pradosh (Purnima lasts 3.5 prahars into it)",
        "tithi": {
          "number": 15,
          "id": "purnima",
          "paksha": "shukla",
          "start": "2026-03-02T12:27:00.000Z",
          "end": "2026-03-03T11:38:00.000Z"
        },
        "windows": [
          {
            "id": "holika_dahan",
            "start": "2026-03-03T12:52:00.000Z",
            "end": "2026-03-03T15:20:12.000Z"
          },
          {
            "id": "bhadra_punchha",
            "start": "2026-03-02T19:56:48.000Z",
            "end": "2026-03-02T21:06:00.000Z"
          },
          {
            "id": "bhadra_mukha",
            "start": "2026-03-02T21:06:00.000Z",
            "end": "2026-03-02T23:01:20.000Z"
          }
        ],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "holi",
        "name": "Holi (Rangwali Holi)",
        "name_hi": "होली (रंगवाली होली)",
        "date": "2026-03-04",
        "rule": "the day after Holika Dahan",
        "tithi": {
          "number": 15,
          "id": "purnima",
          "paksha": "shukla",
          "start": "2026-03-02T12:27:00.000Z",
          "end": "2026-03-03T11:38:00.000Z"
        },
        "windows": [],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "rama_navami",
        "name": "Rama Navami",
        "name_hi": "राम नवमी",
        "date": "2026-03-26",
        "rule": "the day whose Madhyahna (the 3rd fifth of daytime) Chaitra Shukla Navami covers most; Vaishnava: the day whose sunrise it holds",
        "tithi": {
          "number": 9,
          "id": "navami",
          "paksha": "shukla",
          "start": "2026-03-26T06:20:00.000Z",
          "end": "2026-03-27T04:38:00.000Z"
        },
        "windows": [
          {
            "id": "madhyahna",
            "start": "2026-03-26T05:43:12.000Z",
            "end": "2026-03-26T08:10:48.000Z"
          }
        ],
        "moments": [
          {
            "id": "madhyahna_moment",
            "at": "2026-03-26T06:57:00.000Z"
          }
        ],
        "vaishnava": {
          "date": "2026-03-27"
        },
        "verified": true,
        "flags": []
      },
      {
        "id": "raksha_bandhan",
        "name": "Raksha Bandhan",
        "name_hi": "रक्षा बंधन",
        "date": "2026-08-28",
        "rule": "Shravana Purnima after Bhadra: its Aparahna, else its pradosh (either day), else the next morning while the Purnima lasts",
        "tithi": {
          "number": 15,
          "id": "purnima",
          "paksha": "shukla",
          "start": "2026-08-27T03:40:00.000Z",
          "end": "2026-08-28T04:19:00.000Z"
        },
        "windows": [
          {
            "id": "rakhi",
            "start": "2026-08-28T00:27:00.000Z",
            "end": "2026-08-28T04:19:00.000Z"
          }
        ],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "krishna_janmashtami",
        "name": "Krishna Janmashtami",
        "name_hi": "कृष्ण जन्माष्टमी",
        "date": "2026-09-04",
        "rule": "the night whose nishita Krishna Ashtami (amanta Shravana, purnimanta Bhadrapada) covers most (Smarta; the Vaishnava date is not computed)",
        "tithi": {
          "number": 23,
          "id": "ashtami",
          "paksha": "krishna",
          "start": "2026-09-03T20:56:00.000Z",
          "end": "2026-09-04T18:44:00.000Z"
        },
        "windows": [
          {
            "id": "nishita",
            "start": "2026-09-04T18:27:16.000Z",
            "end": "2026-09-04T19:12:44.000Z"
          }
        ],
        "moments": [
          {
            "id": "midnight",
            "at": "2026-09-04T18:50:00.000Z"
          }
        ],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "ganesh_chaturthi",
        "name": "Ganesh Chaturthi",
        "name_hi": "गणेश चतुर्थी",
        "date": "2026-09-14",
        "rule": "the day whose Madhyahna (the 3rd fifth of daytime) Bhadrapada Shukla Chaturthi covers most",
        "tithi": {
          "number": 4,
          "id": "chaturthi",
          "paksha": "shukla",
          "start": "2026-09-14T01:38:00.000Z",
          "end": "2026-09-15T02:15:00.000Z"
        },
        "windows": [
          {
            "id": "madhyahna",
            "start": "2026-09-14T05:32:48.000Z",
            "end": "2026-09-14T08:01:12.000Z"
          }
        ],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "purnima_shraddha",
        "name": "Purnima Shraddha",
        "name_hi": "पूर्णिमा श्राद्ध",
        "date": "2026-09-26",
        "rule": "the day whose Aparahna (the 4th fifth of daytime) the tithi covers most",
        "tithi": {
          "number": 15,
          "id": "purnima",
          "paksha": "shukla",
          "start": "2026-09-25T17:38:00.000Z",
          "end": "2026-09-26T16:49:00.000Z"
        },
        "windows": [
          {
            "id": "kutup",
            "start": "2026-09-26T06:17:56.000Z",
            "end": "2026-09-26T07:06:04.000Z"
          },
          {
            "id": "rauhina",
            "start": "2026-09-26T07:06:04.000Z",
            "end": "2026-09-26T07:54:12.000Z"
          },
          {
            "id": "aparahna",
            "start": "2026-09-26T07:54:12.000Z",
            "end": "2026-09-26T10:18:36.000Z"
          }
        ],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "pratipada_shraddha",
        "name": "Pratipada Shraddha",
        "name_hi": "प्रतिपदा श्राद्ध",
        "date": "2026-09-27",
        "rule": "the day whose Aparahna (the 4th fifth of daytime) the tithi covers most",
        "tithi": {
          "number": 16,
          "id": "pratipada",
          "paksha": "krishna",
          "start": "2026-09-26T16:49:00.000Z",
          "end": "2026-09-27T15:30:00.000Z"
        },
        "windows": [
          {
            "id": "kutup",
            "start": "2026-09-27T06:18:00.000Z",
            "end": "2026-09-27T07:06:00.000Z"
          },
          {
            "id": "rauhina",
            "start": "2026-09-27T07:06:00.000Z",
            "end": "2026-09-27T07:54:00.000Z"
          },
          {
            "id": "aparahna",
            "start": "2026-09-27T07:54:00.000Z",
            "end": "2026-09-27T10:18:00.000Z"
          }
        ],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "dwitiya_shraddha",
        "name": "Dwitiya Shraddha",
        "name_hi": "द्वितीया श्राद्ध",
        "date": "2026-09-28",
        "rule": "the day whose Aparahna (the 4th fifth of daytime) the tithi covers most",
        "tithi": {
          "number": 17,
          "id": "dwitiya",
          "paksha": "krishna",
          "start": "2026-09-27T15:30:00.000Z",
          "end": "2026-09-28T13:44:00.000Z"
        },
        "windows": [
          {
            "id": "kutup",
            "start": "2026-09-28T06:17:32.000Z",
            "end": "2026-09-28T07:05:28.000Z"
          },
          {
            "id": "rauhina",
            "start": "2026-09-28T07:05:28.000Z",
            "end": "2026-09-28T07:53:24.000Z"
          },
          {
            "id": "aparahna",
            "start": "2026-09-28T07:53:24.000Z",
            "end": "2026-09-28T10:17:12.000Z"
          }
        ],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "tritiya_shraddha",
        "name": "Tritiya Shraddha",
        "name_hi": "तृतीया श्राद्ध",
        "date": "2026-09-29",
        "rule": "the day whose Aparahna (the 4th fifth of daytime) the tithi covers most",
        "tithi": {
          "number": 18,
          "id": "tritiya",
          "paksha": "krishna",
          "start": "2026-09-28T13:44:00.000Z",
          "end": "2026-09-29T11:41:00.000Z"
        },
        "windows": [
          {
            "id": "kutup",
            "start": "2026-09-29T06:17:36.000Z",
            "end": "2026-09-29T07:05:24.000Z"
          },
          {
            "id": "rauhina",
            "start": "2026-09-29T07:05:24.000Z",
            "end": "2026-09-29T07:53:12.000Z"
          },
          {
            "id": "aparahna",
            "start": "2026-09-29T07:53:12.000Z",
            "end": "2026-09-29T10:16:36.000Z"
          }
        ],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "maha_bharani_shraddha",
        "name": "Maha Bharani Shraddha",
        "name_hi": "महा भरणी श्राद्ध",
        "date": "2026-09-29",
        "rule": "the day in Pitru Paksha whose Aparahna midpoint is in Bharani nakshatra",
        "tithi": {
          "number": 18,
          "id": "tritiya",
          "paksha": "krishna",
          "start": "2026-09-28T13:44:00.000Z",
          "end": "2026-09-29T11:41:00.000Z"
        },
        "windows": [
          {
            "id": "kutup",
            "start": "2026-09-29T06:17:36.000Z",
            "end": "2026-09-29T07:05:24.000Z"
          },
          {
            "id": "rauhina",
            "start": "2026-09-29T07:05:24.000Z",
            "end": "2026-09-29T07:53:12.000Z"
          },
          {
            "id": "aparahna",
            "start": "2026-09-29T07:53:12.000Z",
            "end": "2026-09-29T10:16:36.000Z"
          }
        ],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "chaturthi_shraddha",
        "name": "Chaturthi Shraddha",
        "name_hi": "चतुर्थी श्राद्ध",
        "date": "2026-09-30",
        "rule": "the day whose Aparahna (the 4th fifth of daytime) the tithi covers most",
        "tithi": {
          "number": 19,
          "id": "chaturthi",
          "paksha": "krishna",
          "start": "2026-09-29T11:41:00.000Z",
          "end": "2026-09-30T09:26:00.000Z"
        },
        "windows": [
          {
            "id": "kutup",
            "start": "2026-09-30T06:17:08.000Z",
            "end": "2026-09-30T07:04:52.000Z"
          },
          {
            "id": "rauhina",
            "start": "2026-09-30T07:04:52.000Z",
            "end": "2026-09-30T07:52:36.000Z"
          },
          {
            "id": "aparahna",
            "start": "2026-09-30T07:52:36.000Z",
            "end": "2026-09-30T10:15:48.000Z"
          }
        ],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "panchami_shraddha",
        "name": "Panchami Shraddha",
        "name_hi": "पंचमी श्राद्ध",
        "date": "2026-09-30",
        "rule": "the day whose Aparahna (the 4th fifth of daytime) the tithi covers most",
        "tithi": {
          "number": 20,
          "id": "panchami",
          "paksha": "krishna",
          "start": "2026-09-30T09:26:00.000Z",
          "end": "2026-10-01T07:06:00.000Z"
        },
        "windows": [
          {
            "id": "kutup",
            "start": "2026-09-30T06:17:08.000Z",
            "end": "2026-09-30T07:04:52.000Z"
          },
          {
            "id": "rauhina",
            "start": "2026-09-30T07:04:52.000Z",
            "end": "2026-09-30T07:52:36.000Z"
          },
          {
            "id": "aparahna",
            "start": "2026-09-30T07:52:36.000Z",
            "end": "2026-09-30T10:15:48.000Z"
          }
        ],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "shashthi_shraddha",
        "name": "Shashthi Shraddha",
        "name_hi": "षष्ठी श्राद्ध",
        "date": "2026-10-01",
        "rule": "the day whose Aparahna (the 4th fifth of daytime) the tithi covers most",
        "tithi": {
          "number": 21,
          "id": "shashthi",
          "paksha": "krishna",
          "start": "2026-10-01T07:06:00.000Z",
          "end": "2026-10-02T04:46:00.000Z"
        },
        "windows": [
          {
            "id": "kutup",
            "start": "2026-10-01T06:16:44.000Z",
            "end": "2026-10-01T07:04:16.000Z"
          },
          {
            "id": "rauhina",
            "start": "2026-10-01T07:04:16.000Z",
            "end": "2026-10-01T07:51:48.000Z"
          },
          {
            "id": "aparahna",
            "start": "2026-10-01T07:51:48.000Z",
            "end": "2026-10-01T10:14:24.000Z"
          }
        ],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "saptami_shraddha",
        "name": "Saptami Shraddha",
        "name_hi": "सप्तमी श्राद्ध",
        "date": "2026-10-02",
        "rule": "the day whose Aparahna (the 4th fifth of daytime) the tithi covers most",
        "tithi": {
          "number": 22,
          "id": "saptami",
          "paksha": "krishna",
          "start": "2026-10-02T04:46:00.000Z",
          "end": "2026-10-03T02:31:00.000Z"
        },
        "windows": [
          {
            "id": "kutup",
            "start": "2026-10-02T06:16:48.000Z",
            "end": "2026-10-02T07:04:12.000Z"
          },
          {
            "id": "rauhina",
            "start": "2026-10-02T07:04:12.000Z",
            "end": "2026-10-02T07:51:36.000Z"
          },
          {
            "id": "aparahna",
            "start": "2026-10-02T07:51:36.000Z",
            "end": "2026-10-02T10:13:48.000Z"
          }
        ],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "ashtami_shraddha",
        "name": "Ashtami Shraddha",
        "name_hi": "अष्टमी श्राद्ध",
        "date": "2026-10-03",
        "rule": "the day whose Aparahna (the 4th fifth of daytime) the tithi covers most",
        "tithi": {
          "number": 23,
          "id": "ashtami",
          "paksha": "krishna",
          "start": "2026-10-03T02:31:00.000Z",
          "end": "2026-10-04T00:23:00.000Z"
        },
        "windows": [
          {
            "id": "kutup",
            "start": "2026-10-03T06:16:20.000Z",
            "end": "2026-10-03T07:03:40.000Z"
          },
          {
            "id": "rauhina",
            "start": "2026-10-03T07:03:40.000Z",
            "end": "2026-10-03T07:51:00.000Z"
          },
          {
            "id": "aparahna",
            "start": "2026-10-03T07:51:00.000Z",
            "end": "2026-10-03T10:13:00.000Z"
          }
        ],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "navami_shraddha",
        "name": "Navami Shraddha",
        "name_hi": "नवमी श्राद्ध",
        "date": "2026-10-04",
        "rule": "the day whose Aparahna (the 4th fifth of daytime) the tithi covers most",
        "tithi": {
          "number": 24,
          "id": "navami",
          "paksha": "krishna",
          "start": "2026-10-04T00:23:00.000Z",
          "end": "2026-10-04T22:25:00.000Z"
        },
        "windows": [
          {
            "id": "kutup",
            "start": "2026-10-04T06:16:24.000Z",
            "end": "2026-10-04T07:03:36.000Z"
          },
          {
            "id": "rauhina",
            "start": "2026-10-04T07:03:36.000Z",
            "end": "2026-10-04T07:50:48.000Z"
          },
          {
            "id": "aparahna",
            "start": "2026-10-04T07:50:48.000Z",
            "end": "2026-10-04T10:12:24.000Z"
          }
        ],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "dashami_shraddha",
        "name": "Dashami Shraddha",
        "name_hi": "दशमी श्राद्ध",
        "date": "2026-10-05",
        "rule": "the day whose Aparahna (the 4th fifth of daytime) the tithi covers most",
        "tithi": {
          "number": 25,
          "id": "dashami",
          "paksha": "krishna",
          "start": "2026-10-04T22:25:00.000Z",
          "end": "2026-10-05T20:38:00.000Z"
        },
        "windows": [
          {
            "id": "kutup",
            "start": "2026-10-05T06:15:56.000Z",
            "end": "2026-10-05T07:03:04.000Z"
          },
          {
            "id": "rauhina",
            "start": "2026-10-05T07:03:04.000Z",
            "end": "2026-10-05T07:50:12.000Z"
          },
          {
            "id": "aparahna",
            "start": "2026-10-05T07:50:12.000Z",
            "end": "2026-10-05T10:11:36.000Z"
          }
        ],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "ekadashi_shraddha",
        "name": "Ekadashi Shraddha",
        "name_hi": "एकादशी श्राद्ध",
        "date": "2026-10-06",
        "rule": "the day whose Aparahna (the 4th fifth of daytime) the tithi covers most",
        "tithi": {
          "number": 26,
          "id": "ekadashi",
          "paksha": "krishna",
          "start": "2026-10-05T20:38:00.000Z",
          "end": "2026-10-06T19:05:00.000Z"
        },
        "windows": [
          {
            "id": "kutup",
            "start": "2026-10-06T06:16:00.000Z",
            "end": "2026-10-06T07:03:00.000Z"
          },
          {
            "id": "rauhina",
            "start": "2026-10-06T07:03:00.000Z",
            "end": "2026-10-06T07:50:00.000Z"
          },
          {
            "id": "aparahna",
            "start": "2026-10-06T07:50:00.000Z",
            "end": "2026-10-06T10:11:00.000Z"
          }
        ],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "dwadashi_shraddha",
        "name": "Dwadashi Shraddha",
        "name_hi": "द्वादशी श्राद्ध",
        "date": "2026-10-07",
        "rule": "the day whose Aparahna (the 4th fifth of daytime) the tithi covers most",
        "tithi": {
          "number": 27,
          "id": "dwadashi",
          "paksha": "krishna",
          "start": "2026-10-06T19:05:00.000Z",
          "end": "2026-10-07T17:47:00.000Z"
        },
        "windows": [
          {
            "id": "kutup",
            "start": "2026-10-07T06:15:04.000Z",
            "end": "2026-10-07T07:01:56.000Z"
          },
          {
            "id": "rauhina",
            "start": "2026-10-07T07:01:56.000Z",
            "end": "2026-10-07T07:48:48.000Z"
          },
          {
            "id": "aparahna",
            "start": "2026-10-07T07:48:48.000Z",
            "end": "2026-10-07T10:09:24.000Z"
          }
        ],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "magha_shraddha",
        "name": "Magha Shraddha",
        "name_hi": "मघा श्राद्ध",
        "date": "2026-10-07",
        "rule": "the day in Pitru Paksha whose Aparahna midpoint is in Magha nakshatra",
        "tithi": {
          "number": 27,
          "id": "dwadashi",
          "paksha": "krishna",
          "start": "2026-10-06T19:05:00.000Z",
          "end": "2026-10-07T17:47:00.000Z"
        },
        "windows": [
          {
            "id": "kutup",
            "start": "2026-10-07T06:15:04.000Z",
            "end": "2026-10-07T07:01:56.000Z"
          },
          {
            "id": "rauhina",
            "start": "2026-10-07T07:01:56.000Z",
            "end": "2026-10-07T07:48:48.000Z"
          },
          {
            "id": "aparahna",
            "start": "2026-10-07T07:48:48.000Z",
            "end": "2026-10-07T10:09:24.000Z"
          }
        ],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "trayodashi_shraddha",
        "name": "Trayodashi Shraddha",
        "name_hi": "त्रयोदशी श्राद्ध",
        "date": "2026-10-08",
        "rule": "the day whose Aparahna (the 4th fifth of daytime) the tithi covers most",
        "tithi": {
          "number": 28,
          "id": "trayodashi",
          "paksha": "krishna",
          "start": "2026-10-07T17:47:00.000Z",
          "end": "2026-10-08T16:47:00.000Z"
        },
        "windows": [
          {
            "id": "kutup",
            "start": "2026-10-08T06:15:08.000Z",
            "end": "2026-10-08T07:01:52.000Z"
          },
          {
            "id": "rauhina",
            "start": "2026-10-08T07:01:52.000Z",
            "end": "2026-10-08T07:48:36.000Z"
          },
          {
            "id": "aparahna",
            "start": "2026-10-08T07:48:36.000Z",
            "end": "2026-10-08T10:08:48.000Z"
          }
        ],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "chaturdashi_shraddha",
        "name": "Chaturdashi Shraddha",
        "name_hi": "चतुर्दशी श्राद्ध",
        "date": "2026-10-09",
        "rule": "the day whose Aparahna (the 4th fifth of daytime) the tithi covers most",
        "tithi": {
          "number": 29,
          "id": "chaturdashi",
          "paksha": "krishna",
          "start": "2026-10-08T16:47:00.000Z",
          "end": "2026-10-09T16:07:00.000Z"
        },
        "windows": [
          {
            "id": "kutup",
            "start": "2026-10-09T06:14:40.000Z",
            "end": "2026-10-09T07:01:20.000Z"
          },
          {
            "id": "rauhina",
            "start": "2026-10-09T07:01:20.000Z",
            "end": "2026-10-09T07:48:00.000Z"
          },
          {
            "id": "aparahna",
            "start": "2026-10-09T07:48:00.000Z",
            "end": "2026-10-09T10:08:00.000Z"
          }
        ],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "sarvapitri_amavasya",
        "name": "Sarvapitri Amavasya",
        "name_hi": "सर्वपितृ अमावस्या",
        "date": "2026-10-10",
        "rule": "the day whose Aparahna (the 4th fifth of daytime) the tithi covers most",
        "tithi": {
          "number": 30,
          "id": "amavasya",
          "paksha": "krishna",
          "start": "2026-10-09T16:07:00.000Z",
          "end": "2026-10-10T15:50:00.000Z"
        },
        "windows": [
          {
            "id": "kutup",
            "start": "2026-10-10T06:14:44.000Z",
            "end": "2026-10-10T07:01:16.000Z"
          },
          {
            "id": "rauhina",
            "start": "2026-10-10T07:01:16.000Z",
            "end": "2026-10-10T07:47:48.000Z"
          },
          {
            "id": "aparahna",
            "start": "2026-10-10T07:47:48.000Z",
            "end": "2026-10-10T10:07:24.000Z"
          }
        ],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "navratri_day_1",
        "name": "Navratri day 1: Shailaputri",
        "name_hi": "नवरात्रि दिन 1: शैलपुत्री",
        "date": "2026-10-11",
        "rule": "the day whose sunrise the tithi holds (udaya tithi)",
        "tithi": {
          "number": 1,
          "id": "pratipada",
          "paksha": "shukla",
          "start": "2026-10-10T15:50:00.000Z",
          "end": "2026-10-11T16:02:00.000Z"
        },
        "windows": [],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "navratri_day_2",
        "name": "Navratri day 2: Brahmacharini",
        "name_hi": "नवरात्रि दिन 2: ब्रह्मचारिणी",
        "date": "2026-10-12",
        "rule": "the day whose sunrise the tithi holds (udaya tithi)",
        "tithi": {
          "number": 2,
          "id": "dwitiya",
          "paksha": "shukla",
          "start": "2026-10-11T16:02:00.000Z",
          "end": "2026-10-12T16:44:00.000Z"
        },
        "windows": [],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "navratri_day_3",
        "name": "Navratri day 3: Chandraghanta",
        "name_hi": "नवरात्रि दिन 3: चंद्रघंटा",
        "date": "2026-10-13",
        "rule": "the day whose sunrise the tithi holds (udaya tithi)",
        "tithi": {
          "number": 3,
          "id": "tritiya",
          "paksha": "shukla",
          "start": "2026-10-12T16:44:00.000Z",
          "end": "2026-10-13T17:59:00.000Z"
        },
        "windows": [],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "navratri_day_4",
        "name": "Navratri day 4: Kushmanda",
        "name_hi": "नवरात्रि दिन 4: कूष्मांडा",
        "date": "2026-10-14",
        "rule": "the day whose sunrise the tithi holds (udaya tithi)",
        "tithi": {
          "number": 4,
          "id": "chaturthi",
          "paksha": "shukla",
          "start": "2026-10-13T17:59:00.000Z",
          "end": "2026-10-14T19:44:00.000Z"
        },
        "windows": [],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "navratri_day_5",
        "name": "Navratri day 5: Skandamata",
        "name_hi": "नवरात्रि दिन 5: स्कंदमाता",
        "date": "2026-10-15",
        "rule": "the day whose sunrise the tithi holds (udaya tithi)",
        "tithi": {
          "number": 5,
          "id": "panchami",
          "paksha": "shukla",
          "start": "2026-10-14T19:44:00.000Z",
          "end": "2026-10-15T21:56:00.000Z"
        },
        "windows": [],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "navratri_day_6",
        "name": "Navratri day 6: Katyayani",
        "name_hi": "नवरात्रि दिन 6: कात्यायनी",
        "date": "2026-10-16",
        "rule": "the day whose sunrise the tithi holds (udaya tithi)",
        "tithi": {
          "number": 6,
          "id": "shashthi",
          "paksha": "shukla",
          "start": "2026-10-15T21:56:00.000Z",
          "end": "2026-10-17T00:25:00.000Z"
        },
        "windows": [],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "navratri_day_7",
        "name": "Navratri day 7: Kalaratri",
        "name_hi": "नवरात्रि दिन 7: कालरात्रि",
        "date": "2026-10-17",
        "rule": "the day whose sunrise the tithi holds (udaya tithi)",
        "tithi": {
          "number": 7,
          "id": "saptami",
          "paksha": "shukla",
          "start": "2026-10-17T00:25:00.000Z",
          "end": "2026-10-18T02:59:00.000Z"
        },
        "windows": [],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "navratri_day_8",
        "name": "Navratri day 8: Durga Ashtami, Mahagauri",
        "name_hi": "नवरात्रि दिन 8: दुर्गा अष्टमी, महागौरी",
        "date": "2026-10-19",
        "rule": "the day whose sunrise the tithi holds (udaya tithi)",
        "tithi": {
          "number": 8,
          "id": "ashtami",
          "paksha": "shukla",
          "start": "2026-10-18T02:59:00.000Z",
          "end": "2026-10-19T05:23:00.000Z"
        },
        "windows": [],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "sandhi_puja",
        "name": "Sandhi Puja",
        "name_hi": "संधि पूजा",
        "date": "2026-10-19",
        "rule": "the last 24 minutes of Ashtami and the first 24 of Navami",
        "tithi": {
          "number": 9,
          "id": "navami",
          "paksha": "shukla",
          "start": "2026-10-19T05:23:00.000Z",
          "end": "2026-10-20T07:21:00.000Z"
        },
        "windows": [
          {
            "id": "sandhi_puja",
            "start": "2026-10-19T04:59:00.000Z",
            "end": "2026-10-19T05:47:00.000Z"
          }
        ],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "navratri_day_9",
        "name": "Navratri day 9: Maha Navami, Siddhidatri",
        "name_hi": "नवरात्रि दिन 9: महानवमी, सिद्धिदात्री",
        "date": "2026-10-20",
        "rule": "the day whose sunrise the tithi holds (udaya tithi)",
        "tithi": {
          "number": 9,
          "id": "navami",
          "paksha": "shukla",
          "start": "2026-10-19T05:23:00.000Z",
          "end": "2026-10-20T07:21:00.000Z"
        },
        "windows": [],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "vijayadashami",
        "name": "Vijayadashami (Dussehra)",
        "name_hi": "विजयादशमी (दशहरा)",
        "date": "2026-10-20",
        "rule": "the day whose Aparahna Dashami covers most",
        "tithi": {
          "number": 10,
          "id": "dashami",
          "paksha": "shukla",
          "start": "2026-10-20T07:21:00.000Z",
          "end": "2026-10-21T08:43:00.000Z"
        },
        "windows": [
          {
            "id": "aparahna",
            "start": "2026-10-20T07:44:12.000Z",
            "end": "2026-10-20T10:00:36.000Z"
          },
          {
            "id": "vijay_muhurat",
            "start": "2026-10-20T08:29:40.000Z",
            "end": "2026-10-20T09:15:08.000Z"
          }
        ],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "sharad_purnima",
        "name": "Sharad Purnima (Kojagari)",
        "name_hi": "शरद पूर्णिमा (कोजागरी)",
        "date": "2026-10-25",
        "rule": "the evening whose moonrise Ashwin Purnima holds; Kojagari puja at nishita (the 8th night-muhurta)",
        "tithi": {
          "number": 15,
          "id": "purnima",
          "paksha": "shukla",
          "start": "2026-10-25T06:27:00.000Z",
          "end": "2026-10-26T04:12:00.000Z"
        },
        "windows": [
          {
            "id": "nishita",
            "start": "2026-10-25T18:09:56.000Z",
            "end": "2026-10-25T19:01:04.000Z"
          }
        ],
        "moments": [
          {
            "id": "moonrise",
            "at": "2026-10-25T11:30:11.386Z"
          }
        ],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "valmiki_jayanti",
        "name": "Valmiki Jayanti",
        "name_hi": "वाल्मीकि जयंती",
        "date": "2026-10-26",
        "rule": "the day whose sunrise the tithi holds (udaya tithi)",
        "tithi": {
          "number": 15,
          "id": "purnima",
          "paksha": "shukla",
          "start": "2026-10-25T06:27:00.000Z",
          "end": "2026-10-26T04:12:00.000Z"
        },
        "windows": [],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "karwa_chauth",
        "name": "Karwa Chauth",
        "name_hi": "करवा चौथ",
        "date": "2026-10-29",
        "rule": "the day whose moonrise the tithi holds; the fast ends at moonrise",
        "tithi": {
          "number": 19,
          "id": "chaturthi",
          "paksha": "krishna",
          "start": "2026-10-28T19:38:00.000Z",
          "end": "2026-10-29T16:41:00.000Z"
        },
        "windows": [],
        "moments": [
          {
            "id": "moonrise",
            "at": "2026-10-29T14:46:51.920Z"
          }
        ],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "ahoi_ashtami",
        "name": "Ahoi Ashtami",
        "name_hi": "अहोई अष्टमी",
        "date": "2026-11-01",
        "rule": "the day whose sunset (the start of pradosh) the tithi holds; the fast ends when the stars show (civil dusk)",
        "tithi": {
          "number": 23,
          "id": "ashtami",
          "paksha": "krishna",
          "start": "2026-11-01T09:23:00.000Z",
          "end": "2026-11-02T07:41:00.000Z"
        },
        "windows": [],
        "moments": [
          {
            "id": "star_sighting",
            "at": "2026-11-01T12:30:31.158Z"
          },
          {
            "id": "moonrise",
            "at": "2026-11-01T18:10:18.217Z"
          }
        ],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "dhanteras",
        "name": "Dhanteras",
        "name_hi": "धनतेरस",
        "date": "2026-11-06",
        "rule": "the day whose sunset (the start of pradosh) the tithi holds; puja: pradosh within the Vrishabha (fixed) lagna",
        "tithi": {
          "number": 28,
          "id": "trayodashi",
          "paksha": "krishna",
          "start": "2026-11-06T05:01:00.000Z",
          "end": "2026-11-07T05:19:00.000Z"
        },
        "windows": [
          {
            "id": "pradosh",
            "start": "2026-11-06T12:03:00.000Z",
            "end": "2026-11-06T14:27:00.000Z"
          },
          {
            "id": "vrishabha_lagna",
            "start": "2026-11-06T12:33:00.000Z",
            "end": "2026-11-06T14:29:00.000Z"
          },
          {
            "id": "puja",
            "start": "2026-11-06T12:33:00.000Z",
            "end": "2026-11-06T14:27:00.000Z"
          }
        ],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "kali_chaudas",
        "name": "Kali Chaudas",
        "name_hi": "काली चौदस",
        "date": "2026-11-07",
        "rule": "the night at whose midnight Chaturdashi prevails",
        "tithi": {
          "number": 29,
          "id": "chaturdashi",
          "paksha": "krishna",
          "start": "2026-11-07T05:19:00.000Z",
          "end": "2026-11-08T05:59:00.000Z"
        },
        "windows": [],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "narak_chaturdashi",
        "name": "Narak Chaturdashi",
        "name_hi": "नरक चतुर्दशी",
        "date": "2026-11-08",
        "rule": "the day whose last minute before sunrise Chaturdashi holds; abhyanga snan from moonrise to sunrise",
        "tithi": {
          "number": 29,
          "id": "chaturdashi",
          "paksha": "krishna",
          "start": "2026-11-07T05:19:00.000Z",
          "end": "2026-11-08T05:59:00.000Z"
        },
        "windows": [
          {
            "id": "abhyanga_snan",
            "start": "2026-11-08T00:10:53.039Z",
            "end": "2026-11-08T01:08:00.000Z"
          }
        ],
        "moments": [
          {
            "id": "moonrise",
            "at": "2026-11-08T00:10:53.039Z"
          },
          {
            "id": "sunrise",
            "at": "2026-11-08T01:08:00.000Z"
          }
        ],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "diwali",
        "name": "Diwali (Lakshmi Puja)",
        "name_hi": "दीपावली (लक्ष्मी पूजा)",
        "date": "2026-11-08",
        "rule": "the day whose sunset (the start of pradosh) the tithi holds; Lakshmi Puja: pradosh within the Vrishabha (fixed) lagna",
        "tithi": {
          "number": 30,
          "id": "amavasya",
          "paksha": "krishna",
          "start": "2026-11-08T05:59:00.000Z",
          "end": "2026-11-09T07:02:00.000Z"
        },
        "windows": [
          {
            "id": "pradosh",
            "start": "2026-11-08T12:01:00.000Z",
            "end": "2026-11-08T14:25:00.000Z"
          },
          {
            "id": "vrishabha_lagna",
            "start": "2026-11-08T12:25:00.000Z",
            "end": "2026-11-08T14:21:00.000Z"
          },
          {
            "id": "lakshmi_puja",
            "start": "2026-11-08T12:25:00.000Z",
            "end": "2026-11-08T14:21:00.000Z"
          }
        ],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "govardhan_puja",
        "name": "Govardhan Puja",
        "name_hi": "गोवर्धन पूजा",
        "date": "2026-11-10",
        "rule": "the day whose sunrise the tithi holds (udaya tithi); pratahkal and sayankal only where Pratipada holds them",
        "tithi": {
          "number": 1,
          "id": "pratipada",
          "paksha": "shukla",
          "start": "2026-11-09T07:02:00.000Z",
          "end": "2026-11-10T08:31:00.000Z"
        },
        "windows": [
          {
            "id": "pratahkal",
            "start": "2026-11-10T01:10:00.000Z",
            "end": "2026-11-10T03:20:00.000Z"
          }
        ],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "bhai_dooj",
        "name": "Bhai Dooj",
        "name_hi": "भाई दूज",
        "date": "2026-11-11",
        "rule": "the day whose Aparahna Kartika Dwitiya covers most",
        "tithi": {
          "number": 2,
          "id": "dwitiya",
          "paksha": "shukla",
          "start": "2026-11-10T08:31:00.000Z",
          "end": "2026-11-11T10:24:00.000Z"
        },
        "windows": [
          {
            "id": "aparahna",
            "start": "2026-11-11T07:40:00.000Z",
            "end": "2026-11-11T09:50:00.000Z"
          }
        ],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "akshaya_navami",
        "name": "Akshaya Navami",
        "name_hi": "अक्षय नवमी",
        "date": "2026-11-18",
        "rule": "the day whose sunrise the tithi holds (udaya tithi)",
        "tithi": {
          "number": 9,
          "id": "navami",
          "paksha": "shukla",
          "start": "2026-11-18T00:36:00.000Z",
          "end": "2026-11-19T01:37:00.000Z"
        },
        "windows": [],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "kartik_purnima",
        "name": "Kartik Purnima",
        "name_hi": "कार्तिक पूर्णिमा",
        "date": "2026-11-24",
        "rule": "the day whose sunrise the tithi holds (udaya tithi) (the snan day)",
        "tithi": {
          "number": 15,
          "id": "purnima",
          "paksha": "shukla",
          "start": "2026-11-23T18:13:00.000Z",
          "end": "2026-11-24T14:54:00.000Z"
        },
        "windows": [],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      },
      {
        "id": "dev_deepawali",
        "name": "Dev Deepawali",
        "name_hi": "देव दीपावली",
        "date": "2026-11-24",
        "rule": "the day whose sunset (the start of pradosh) the tithi holds",
        "tithi": {
          "number": 15,
          "id": "purnima",
          "paksha": "shukla",
          "start": "2026-11-23T18:13:00.000Z",
          "end": "2026-11-24T14:54:00.000Z"
        },
        "windows": [
          {
            "id": "pradosh",
            "start": "2026-11-24T11:55:00.000Z",
            "end": "2026-11-24T14:19:00.000Z"
          }
        ],
        "moments": [],
        "vaishnava": null,
        "verified": true,
        "flags": []
      }
    ]
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.9.28",
    "mode": "live",
    "credits_charged": 2
  },
  "warnings": []
}
Try it

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one