Get today's panchang for the user's current location

Request: No body - auth token only. Optional date query (YYYY-MM-DD, defaults to today IST).

Returns the daily panchang (tithi, nakshatra, yoga, karana, sunrise/sunset, Rahu Kaal, Gulika Kaal, Yamaganda, Abhijit Muhurat, Choghadiya best/avoid windows) plus what-to-do / not-do / avoid guidance, computed for the user's current location (profiles.current_lat/lng/timezone). Read-through cached per (date, location).

Success: 200 - data.status is done with the full panchang in data.panchang_data plus a top-level data.glossary[] that explains every panchang term (tithi, nakshatra, Rahu Kaal ...) in plain language; or location_required (with data.panchang_data null, no glossary) when the user has no current location set yet.

Errors: 401 invalid/missing token | 422 invalid date format.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Examples

Panchang availableNo current location set

{
    "success": true,
    "message": "Panchang fetched",
    "data": {
        "status": "done",
        "panchang_data": {
            "panchang_date": "2026-06-13",
            "latitude": 19.08,
            "longitude": 72.88,
            "timezone": "Asia/Kolkata",
            "city": "Mumbai",
            "state": "Maharashtra",
            "country": "India",
            "sunrise": "06:04:15",
            "sunset": "19:12:25",
            "tithi": "Krishna Dwadashi",
            "nakshatra": "Ashwini",
            "yoga": "Atiganda",
            "karana": "Kaulava",
            "rahu_kaal": "10:59 - 12:38",
            "gulika_kaal": "07:42 - 09:21",
            "yamaganda": "15:55 - 17:33",
            "abhijit_muhurat": "12:12 - 13:04",
            "what_to_do": [
                "Begin important work during an auspicious Choghadiya window.",
                "Offer prayers around sunrise."
            ],
            "what_not_to_do": [
                "Avoid starting new ventures during Rahu Kaal."
            ],
            "what_to_avoid": [
                "Stay measured during Atiganda yoga - avoid haste."
            ],
            "choghadiya": {
                "day": [
                    {
                        "name": "Char",
                        "type": "neutral",
                        "start": "06:04",
                        "end": "07:42"
                    },
                    {
                        "name": "Labh",
                        "type": "good",
                        "start": "07:42",
                        "end": "09:20"
                    }
                ],
                "night": [
                    {
                        "name": "Shubh",
                        "type": "good",
                        "start": "19:12",
                        "end": "20:34"
                    },
                    {
                        "name": "Amrit",
                        "type": "good",
                        "start": "20:34",
                        "end": "21:56"
                    }
                ]
            },
            "raw_data": {
                "weekday": "Saturday",
                "paksha": "Krishna"
            }
        },
        "glossary": [
            {
                "slug": "nakshatra",
                "term": "Nakshatra",
                "meaning": "The Moon's 'star home' among 27 lunar mansions. It colours the day's energy and your natural instincts."
            }
        ]
    }
}

🟠401Unauthorized

🟠422Parameter Error

Get today's panchang for the user's current location

Request

Request Code Samples

Responses