Skip to content
Occult API
POST/api/astro/monthly_panchang/1 credit

Monthly panchang

One row per calendar day for a whole Gregorian month — the grid a panchang wall calendar prints. Each day carries sunrise, sunset, moonrise and moonset, the weekday in Sanskrit, the lunar month under both reckonings, the Vikram and Shaka years with their sixty-year cycle names, and the tithi, Moon sign and Moon nakshatra prevailing at that day's sunrise. Because a tithi or nakshatra usually changes partway through a day, each of those three carries an exit_time: the exact instant it gives way to the next, or null if it lasts past the following sunrise. That is what lets you render the familiar 'Vrishchika 01:08+' style labels. Pass year, month, latitude, longitude and UTC offset. moon_option chooses which reckoning the row's lunar_month field follows, 'purnimanta' (the default) or 'amanta'; both amanta_month and purnimanta_month are returned on every row regardless, so you can switch presentation without a second call. The response is {year, month, days} with one entry per day of that month.

https://yogataraapi.prahlad.app/api/astro/monthly_panchang/
Test Request

Authentication

Send your key in the X-API-Key header. Keys are server-side credentials — never put one in browser JavaScript or a mobile app.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Request fields

FieldTypeRequiredNotes
latitudenumber (double)required

Latitude of the place, in decimal degrees. Positive is north, negative is south. Example: 26.9124 for Jaipur, 40.7128 for New York. Minutes and seconds are not accepted - convert first.

longitudenumber (double)required

Longitude of the place, in decimal degrees. Positive is east, negative is west. Example: 75.7873 for Jaipur, -74.0060 for New York. Note the sign: a missing minus puts New York in China.

monthintegerrequired

Month of birth as a number, 1-12. January is 1.

min 1 · max 12

timezone_as_floatnumber (double)required

UTC offset of the place, in hours, as a decimal. Example: 5.5 for India (UTC+05:30), -5 for New York in winter, 5.75 for Nepal. This is NOT validated against date_time - if the two disagree you get a successful response for the wrong moment, so derive both from the same source. Use the offset in force on that date, not today's: a summer birth in a country with daylight saving needs the summer offset.

yearintegerrequired

Year of birth as a number, e.g. 1990. Four digits.

min 1800 · max 2400

moon_optionstringoptional
purnimantaamanta

Example request

curl -X POST https://yogataraapi.prahlad.app/api/astro/monthly_panchang/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"latitude":26.9124,"longitude":75.7873,"month":9,"timezone_as_float":5.5,"year":2026,"moon_option":"purnimanta"}'

Response

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"year\": 2026, \"month\": 9, \"days\": [{\"date\": \"2026-09-01\", \"vaara\": \"Mangalavara\", \"lunar_month\": \"Bhadrapada\", \"amanta_month\": \"Shravana\", \"purnimanta_month\": \"Bhadrapada\", \"vikram_samvat\": 2083, \"vikram_samvatsara\": \"Kalayukthi\", \"shaka_samvat\": 1948, \"shaka_samvatsara\": \"Krodhi\", \"sunrise\": \"2026-09-01T06:09:56+05:30\", \"sunset\": \"2026-09-01T18:43:30+05:30\", \"moonrise\": \"2026-09-01T21:09:00+05:30\", \"moonset\": \"2026-09-01T09:53:10+05:30\", \"tithi\": {\"paksha\": \"Krishna\", \"name\": \"Chaturthi\", \"exit_time\": \"2026-09-01T07:42:57+05:30\"}, \"moon_rashi\": {\"name\": \"Mesha\", \"exit_time\": null}, \"moon_nakshatra\": {\"name\": \"Ashwini\", \"exit_time\": \"2026-09-02T02:42:25+05:30\"}, \"sun_rashi\": \"Simha\"}, {\"date\": \"2026-09-02\", \"vaara\": \"Budhavara\", \"lunar_month\": \"Bhadrapada\", \"amanta_month\": \"Shravana\", \"purnimanta_month\": \"Bhadrapada\", \"vikram_samvat\": 2083, \"vikram_samvatsara\": \"Kalayukthi\", \"shaka_samvat\": 1948, \"shaka_samvatsara\": \"Krodhi\", \"sunrise\": \"2026-09-02T06:10:22+05:30\", \"sunset\": \"2026-09-02T18:42:26+05:30\", \"moonrise\": \"2026-09-02T21:50:26+05:30\", \"moonset\": \"2026-09-02T10:57:09+05:30\", \"tithi\": {\"paksha\": \"Krishna\", \"name\": \"Panchami\", \"exit_time\": \"2026-09-02T06:13:35+05:30\"}, \"moon_rashi\": {\"name\": \"Mesha\", \"exit_time\": null}, \"moon_nakshatra\": {\"name\": \"Bharani\", \"exit_time\": \"2026-09-03T01:43:16+05:30\"}, \"sun_rashi\": \"Simha\"}, {\"date\": \"2026-09-03\", \"vaara\": \"Guruvara\", \"lunar_month\": \"Bhadrapada\", \"amanta_month\": \"Shravana\", \"purnimanta_month\": \"Bhadrapada\", \"vikram_samvat\": 2083, \"vikram_samvatsara\": \"Kalayukthi\", \"shaka_samvat\": 1948, \"shaka_samvatsara\": \"Krodhi\", \"sunrise\": \"2026-09-03T06:10:48+05:30\", \"sunset\": \"2026-09-03T18:41:21+05:30\", \"moonrise\": \"2026-09-03T22:38:43+05:30\", \"moonset\": \"2026-09-03T12:03:39+05:30\", \"tithi\": {\"paksha\": \"Krishna\", \"name\": \"Saptami\", \"exit_time\": \"2026-09-04T02:26:25+05:30\"}, \"moon_rashi\": {\"name\": \"Mesha\", \"exit_time\": \"2026-09-03T07:26:05+05:30\"}, \"moon_nakshatra\": {\"name\": \"Krittika\", \"exit_time\": \"2026-09-04T00:29:36+05:30\"}, \"sun_rashi\": \"Simha\"}, {\"date\": \"2026-09-04\", \"vaara\": \"Shukravara\", \"lunar_month\": \"Bhadrapada\", \"amanta_month\": \"Shravana\", \"purnimanta_month\": \"Bhadrapada\", \"vikram_samvat\": 2083, \"vikram_samvatsara\": \"Kalayukthi\", \"shaka_samvat\": 1948, \"shaka_samvatsara\": \"Krodhi\", \"sunrise\": \"2026-09-04T06:11:14+05:30\", \"sunset\": \"2026-09-04T18:40:15+05:30\", \"moonrise\": \"2026-09-04T23:34:48+05:30\", \"moonset\": \"2026-09-04T13:10:53+05:30\", \"tithi\": {\"paksha\": \"Krishna\", \"name\": \"Ashtami\", \"exit_time\": \"2026-09-05T00:14:34+05:30\"}, \"moon_rashi\": {\"name\": \"Vrishabha\", \"exit_time\": null}, \"moon_nakshatra\": {\"name\": \"Rohini\", \"exit_time\": \"2026-09-04T23:04:27+05:30\"}, \"sun_rashi\": \"Simha\"}, {\"date\": \"2026-09-05\", \"vaara\": \"Shanivara\", \"lunar_month\": \"Bhadrapada\", \"amanta_month\": \"Shravana\", \"purnimanta_month\": \"Bhadrapada\", \"vikram_samvat\": 2083, \"vikram_samvatsara\": \"Kalayukthi\", \"shaka_samvat\": 1948, \"shaka_samvatsara\": \"Krodhi\", \"sunrise\": \"2026-09-05T06:11:40+05:30\", \"sunset\": \"2026-09-05T18:39:09+05:30\", \"moonrise\": \"2026-09-06T00:38:03+05:30\", \"moonset\": \"2026-09-05T14:15:49+05:30\", \"tithi\": {\"paksha\": \"Krishna\", \"name\": \"Navami\", \"exit_time\": \"2026-09-05T21:54:40+05:30\"}, \"moon_rashi\": {\"name\": \"Vrishabha\", \"exit_time\": \"2026-09-05T10:18:34+05:30\"}, \"moon_nakshatra\": {\"name\": \"Mrigasira\", \"exit_time\": \"2026-09-05T21:31:03+05:30\"}, \"sun_rashi\": \"Simha\"}, {\"date\": \"2026-09-06\", \"vaara\": \"Ravivara\", \"lunar_month\": \"Bhadrapada\", \"amanta_month\": \"Shravana\", \"purnimanta_month\": \"Bhadrapada\", \"vikram_samvat\": 2083, \"vikram_samvatsara\": \"Kalayukthi\", \"shaka_samvat\": 1948, \"shaka_samvatsara\": \"Krodhi\", \"sunrise\": \"2026-09-06T06:12:06+05:30\", \"sunset\": \"2026-09-06T18:38:03+05:30\", \"moonrise\": \"2026-09-07T01:45:53+05:30\", \"moonset\": \"2026-09-06T15:15:16+05:30\", \"tithi\": {\"paksha\": \"Krishna\", \"name\": \"Dashami\", \"exit_time\": \"2026-09-06T19:30:12+05:30\"}, \"moon_rashi\": {\"name\": \"Mithuna\", \"exit_time\": null}, \"moon_nakshatra\": {\"name\": \"Aardra\", \"exit_time\": \"2026-09-06T19:52:"
}

Captured from a real call using the exact request above. Results sit under data.

Errors

Metering errors return { "error": "…", "message": "<code>", "is_error": true }. Show error to people and branch on message. See the error reference.