curl -X POST https://yogataraapi.prahlad.app/api/astro/attributes/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"2024-11-21T07:45:44.368Z","longitude":76.125,"name":"Ashwini","zodiac":"Aries","lord":"saturn","target_phase":0,"limitdays":30,"year":1,"chart_factor":1}'A grab-bag of twelve small chart quantities returned in one call — the sort of thing you would otherwise make a dozen requests for. It always computes all twelve, whatever you send. The set covers the nakshatra and pada of a given ecliptic longitude, a nakshatra's number and ruling planet by name, the Hadda (Egyptian term) lord of a longitude within a sign, the Kakshya lord and Kakshya number, the zodiac sign of a longitude, which planets are combust at the given moment, the Moon's phase angle, the next occurrence of a chosen lunar phase, the four seasonal ingress moments of a year, and a divisional-chart position derived from a longitude. Only `date_time` is required; everything else falls back to a default (longitude 0, name 'Ashwini', zodiac 'Aries', lord 'saturn', target_phase 0 for new moon, limitdays 30, the current year, chart_factor 1 for the Rashi chart), so a minimal call with just `date_time` and `longitude` already gives you combust planets, moon phase, nakshatra and sign. Two quirks: `lord` is matched case-sensitively against data that stores Mercury capitalised, so 'mercury' silently returns null where 'Mercury' returns a number; and the `when` and `nakshatras` request fields are accepted but never read.
| Field | Type | Required | Notes |
|---|---|---|---|
| date_time | string (date-time) | required | The moment to calculate for, ISO 8601. ALWAYS include an offset or a trailing Z - a value with no zone is read as Asia/Kolkata (UTC+05:30), not UTC, and can return the previous day's result with a 200. '2026-09-01T06:00:00Z' and '2026-09-01 06:00:00' are different instants and give different answers. FORMAT constraint, not an enum. DRF DateTimeField: ISO-8601 only (DRF default input formats), e.g. "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" or "2026-09-01 06:00:00" (no timezone = UTC assumed). |
| chart_factor | integer | optional | Divisional chart factor for dasavarga_from_longitude (1=Rashi, 9=Navamsa, etc.). |
| limitdays | integer | optional | Search window in days for search_moon_phase. |
| longitude | number (double) | optional | 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. min -180 · max 180 |
| lord | string | optional | Planetary lord used by get_kakshya_number. saturnjupitermarssunvenusMercurymoonascendantCase-SENSITIVE exact match. The data itself is inconsistent: seven entries are lowercase but Mercury is stored capitalised as 'Mercury', so 'mercury' silently returns null while 'Mercury' returns 6. A non-matching value returns null with no error. Default 'saturn'. |
| nakshatras | string | optional | |
| name | string | optional | Nakshatra name used by get_nakshatra_details. AardraAasreshaAbhijitAnooraadhaAnuradhaArdraAshleshaAshwiniBharaniChitraDhanishtaDhanishthaNakshatra name feeding the `nakshatra_details` result. Case-insensitive and whitespace-stripped. Both the modern spellings (Mrigashira, Ardra, Pushya, Ashlesha, Magha, Purva Phalguni, Swati, Vishakha, Anuradha, Purva Ashadha, Uttara Ashadha, Shravana, Dhanishta, Shatabhisha, Purva Bhadrapada, Uttara Bhadrapada) and the engine's older transliterations (Mrigasira, Aardra, Pushyami, Aasresha, Makha, Poorva Phalguni, Swaati, Visaakha, Anooraadha, Poorvaashaadha, Uttaraashaadha, Sravanam, Dhanishtha, Satabhishak, Poorvaabhaadra, Uttaraabhaadra) resolve. 'Abhijit' is accepted (28-nakshatra scheme). Default 'Ashwini'. |
| target_phase | integer | optional | Moon phase to search for: 0=new, 1=first quarter, 2=full, 3=last quarter. |
| when | string | optional | |
| year | integer | optional | Year of birth as a number, e.g. 1990. Four digits. |
| zodiac | string | optional | Zodiac sign used by get_hadda_lord. AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces |