POST/api/astro/panchanga_yogas/1 credit

Panchanga yogas

A Panchanga yoga is a named quality a whole day carries, good or bad, arising from the combination of that day's lunar day (tithi), weekday (vaara) and lunar mansion (nakshatra). Sarvartha Siddhi ("all purposes succeed"), Amrit Siddhi, Tripushkara, Dagdha, Mrityu and Yamaghanta are the familiar ones. Muhurta practice uses them as a first filter: pick a day that carries a benefic combination and avoid one that carries a malefic one. This is the day-level scan. It walks every calendar day of the requested year, evaluates the yogas once at that day's sunrise, and returns only the days that carry at least one. The response is `data.days`, a list of `{date, yogas}` where `date` is `YYYY-MM-DD` and `yogas` is a list of names; days with nothing to report are omitted entirely. Most names carry their source convention in brackets, for example "Amrit Yoga (Vaara Tithi Yoga)" or "Padma Yoga (Vashishta Samhita Yogas)", because several classical texts define overlapping sets. The yogas are read at sunrise, so latitude, longitude and `timezone_as_float` all change the result. `use_28_nakshatras` defaults to true and inserts Abhijit as a nakshatra in its own right; some yogas, such as Monday's Kaana Yoga, are defined in terms of Abhijit and cannot appear without it. Set it to false to use the plain 27-nakshatra list. This endpoint is unrelated to `/api/astro/yogas/`, which finds combinations of planets in a birth chart; nothing here looks at a birth chart. For Ravi Yoga specifically, `/api/astro/ravi_yoga/` gives exact start and end times rather than a day flag.

https://yogataraapi.prahlad.app/api/astro/panchanga_yogas/

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

Field	Type	Required	Notes
latitude	number (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.
longitude	number (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.
timezone_as_float	number (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.
year	integer	required	Year of birth as a number, e.g. 1990. Four digits. min 1800 · max 2400
use_28_nakshatras	boolean	optional

Example request

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

Response

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"year\": 2026, \"days\": [{\"date\": \"2026-01-01\", \"yogas\": [\"utpaata\", \"Naasha Yoga (Tithi-Nakshatra-Vaara combination)\", \"Amrit Yoga (Vaara Tithi Yoga)\", \"Utpaata/Pravas (Vaara Nakshatra Malefic/Bad Yoga)\", \"Some adverse combinations (Vaara Nakshatra Malefic/Bad Yoga)\"]}, {\"date\": \"2026-01-02\", \"yogas\": [\"Ravi Yoga (Sun and Moon Nakshatra)\", \"Upagraha Dosha\", \"Amrit Yoga (Vaara Tithi Yoga)\", \"Some adverse combinations as per Vashishta Samhita (Vaara Nakshatra Malefic/Bad Yoga)\", \"Padma Yoga (Vashishta Samhita Yogas)\"]}, {\"date\": \"2026-01-03\", \"yogas\": [\"Mrityu (Vaara Tithi Yoga)\", \"Dushta Yoga (Vaara Nakshatra Malefic/Bad Yoga)\"]}, {\"date\": \"2026-01-05\", \"yogas\": [\"sarvartha_siddhi\", \"Always bestows welfare (Tithi group-Nakshatra combination Benefic/Good Yogas)\", \"Some adverse combinations as per Vashishta Samhita (Vaara Nakshatra Malefic/Bad Yoga)\", \"Ku Yoga (Vaara Nakshatra Malefic/Bad Yoga)\", \"Sarvarth-Siddha Yoga (Vaara Nakshatra Auspicious/Good Yogas)\", \"Maha Yoga (Vashishta Samhita Yogas)\"]}, {\"date\": \"2026-01-06\", \"yogas\": [\"sarvartha_siddhi\", \"Dhumra Vashishta Samhita Yoga (Malefic)\", \"Dushta Yoga (Vaara Nakshatra Malefic/Bad Yoga)\", \"Some adverse combinations as per Vashishta Samhita (Vaara Nakshatra Malefic/Bad Yoga)\", \"Ku Yoga (Vaara Nakshatra Malefic/Bad Yoga)\"]}, {\"date\": \"2026-01-09\", \"yogas\": [\"Ravi Yoga (Sun and Moon Nakshatra)\", \"Ku Yoga (Vaara Nakshatra Malefic/Bad Yoga)\", \"Padma Yoga (Vashishta Samhita Yogas)\"]}, {\"date\": \"2026-01-10\", \"yogas\": [\"mrityu\", \"yama_ghanta\", \"Mrityu/Maran (Vaara Nakshatra Malefic/Bad Yoga)\", \"Yamaghanta (Vaara Nakshatra Malefic/Bad Yoga)\", \"Ku Yoga (Vaara Nakshatra Malefic/Bad Yoga)\", \"Vimardan Yoga (Vashishta Samhita Yogas)\"]}, {\"date\": \"2026-01-11\", \"yogas\": [\"Amrit Yoga (Vaara Nakshatra Auspicious/Good Yogas)\", \"Saumya Yog (Vashishta Samhita Yogas)\"]}, {\"date\": \"2026-01-12\", \"yogas\": [\"Auspicious for all types of works (Tithi group-Nakshatra combination Benefic/Good Yogas)\", \"Ku Yoga (Vaara Nakshatra Malefic/Bad Yoga)\", \"Maha Yoga (Vashishta Samhita Yogas)\"]}, {\"date\": \"2026-01-13\", \"yogas\": [\"Din Mrityu Yoga\", \"Halahalopam Yogas (Vashishta Samhita Yogas)\"]}, {\"date\": \"2026-01-14\", \"yogas\": [\"amrit_siddhi\"]}, {\"date\": \"2026-01-16\", \"yogas\": [\"Upagraha Dosha\", \"Amrit Yoga (Vaara Nakshatra Auspicious/Good Yogas)\", \"Sarvarth-Siddha Yoga (Vaara Nakshatra Auspicious/Good Yogas)\"]}, {\"date\": \"2026-01-17\", \"yogas\": [\"Din Mrityu Yoga\", \"Upagraha Dosha\", \"Prashasta Yoga (Vaara Nakshatra Auspicious/Good Yogas)\", \"Amrit Yoga (Vaara Nakshatra Auspicious/Good Yogas)\"]}, {\"date\": \"2026-01-18\", \"yogas\": [\"Amrit Yoga (Vaara Tithi Yoga)\", \"Dushta Yoga (Vaara Nakshatra Malefic/Bad Yoga)\"]}, {\"date\": \"2026-01-19\", \"yogas\": [\"kaana\", \"Ratnakur Yoga (Vaara Tithi Yoga)\", \"Kaana/Vyadhi (Vaara Nakshatra Malefic/Bad Yoga)\"]}, {\"date\": \"2026-01-20\", \"yogas\": [\"Naasha Yoga (Tithi-Nakshatra-Vaara combination)\", \"Amrit Yoga (Vaara Tithi Yoga)\", \"Some adverse combinations as per Vashishta Samhita (Vaara Nakshatra Malefic/Bad Yoga)\"]}, {\"date\": \"2026-01-21\", \"yogas\": [\"dagdha_nakshatra\", \"panchaka\", \"Auspicious for Manglik works (Tithi group-Nakshatra combination Benefic/Good Yogas)\", \"Tithi-Nakshatra-Vaara combination Malefic/Bad Yogas\", \"Naasha Yoga (Tithi-Nakshatra-Vaara combination)\", \"Mrityu (Vaara Tithi Yoga)\", \"Dagdha (Vashishta's opinion) (Vaara Tithi Yoga)\", \"Dagdha (Brihaspati's opinion) (Vaara Tithi Yoga)\", \"Dagdha (Vaara Nakshatra Malefic/Bad Yoga)\", \"Vish Yoga (Vaara Nakshatra Malefic/Bad Yoga)\", \"Some adverse combinations (Vaara Nakshatra Malefic/Bad Yoga)\"]}, {\"date\": \"2026-01-22\", \"yogas\": [\"panchaka\", \"Tithi-Nakshatra-Vaara combination Malefic/Bad Yogas\", \"Mrityu (Vaara Tithi Yoga)\", \"Dagdha (Brihaspati's opinion) (Vaara Tithi Yoga)\", \"Vish Yoga (Vaara Nakshatra Malefic/Bad Yoga)\", \"Some adverse combinations (Vaara Nakshatra Malefic/Bad Yoga)\", \"Ku Yoga (Vaara Nakshatra Malefic/Bad Yoga)\", \"Amrit Yoga (Vashishta Samhita Yogas)\"]}, {\"date\": \"2026-01-23\", \"yogas\": [\"panchaka\", \"Ratnaku"
}

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.