Calendar

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

OperationCreditsKey
GET /v1/calendar/tithis
Tithi start and end moments between two dates, and the tithi at each sunrise
1secret or publishable
GET /v1/calendar/ekadashi
Every Ekadashi of a year: the vrat date, the tithi and the paran window
1secret or publishable
GET /v1/calendar/festivals
Festivals of a year, each by its own rule, with its windows and moments
2secret or publishable

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

GET /v1/calendar/tithis · 200 OK
{
  "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 in the playground Full reference