POSThttps://yogataraapi.prahlad.app/api/astro/chart_analysis/

Chart analysis

Request bodyJSON

Paste an API key above to send.

Code snippet

curl -X POST https://yogataraapi.prahlad.app/api/astro/chart_analysis/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time_natal":"2025-11-21T05:45:23.715Z","date_time_transit":"2024-11-21T05:45:23.715Z","longitude_natal":77.5946,"latitude_natal":12.9716,"longitude_transit":26.1046,"latitude_transit":26.9124,"chart_name_natal":"RashiChart","chart_name_transit":"RashiChart","ref_celestial":"mercury","target_celestial":"mars","rahu":"true","mode":0}'

Fourteen structural readings of a birth chart in a single call, plus one comparison between a natal chart and a transit chart. This is the interpretive layer above /api/astro/chart/: it does not give you positions, it gives you what those positions amount to. The response always carries the same fields. `house_from_reference_chart` counts the house that `target_celestial` in the transit chart falls in when measured from `ref_celestial` in the natal chart. `kendras` groups the natal bodies by angular house. `argala` and `virodhargala` give the intervening and obstructing planets for each body, keyed by the 2nd, 4th, 5th and 11th and by the 12th, 10th, 9th and 3rd respectively. `bhava_arudhas` and `ghara_arudhas` are the projected images of the houses and the planets. `temporary_relationships` and `compound_relationships` are the chart-specific friendships. `karakas` are the chara karakas, `nakshatra_count` the star distance from the reference body, and `exaltation`, `debilitation`, `mooltrikona`, `own_rashi` and `pachakadi_relations` the dignity checks. Both charts are always Rashi charts: `chart_name_natal` and `chart_name_transit` are free-form labels and do not select a divisional chart despite their names. `mode` chooses eight chara karakas or seven, and `rahu` picks true or mean nodes for the karaka block only. Setting `ref_celestial` to 'ascendant' is allowed and returns null for the two relationship fields, which are planet-to-planet by definition.

Request fields

Field	Type	Required	Notes
chart_name_natal	string	required	FREE-FORM label, NOT a chart-type selector. Despite the name, this endpoint always builds a RashiChart; the string is stored as a display label and never validated. Any non-empty string works.
chart_name_transit	string	required	FREE-FORM label, NOT a chart-type selector. Same as chart_name_natal.
date_time_natal	string (date-time)	required	FORMAT constraint. 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).
date_time_transit	string (date-time)	required	FORMAT constraint. 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).
latitude_natal	number (double)	required	min -180 · max 180
latitude_transit	number (double)	required	min -180 · max 180
longitude_natal	number (double)	required	min -180 · max 180
longitude_transit	number (double)	required	min -180 · max 180
mode	integer	required	`78` Integer, not a string, but constrained: 8 = eight chara karakas (includes Pitri Karaka and Rahu), 7 = seven karakas (Rahu excluded). Only 7 and 8 are meaningful.
rahu	string	required	`truemean` Case-sensitive lowercase. Only 'true' is tested explicitly; any other value (including 'mean' takes the else branch and behaves as 'mean'. Affects the `karakas` block only.
ref_celestial	string	required	`sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutonorthtruenodenorthmeannode` Case-sensitive, all lowercase. 'ascendant' works for the house_from_reference_chart and nakshatra_count parts; when ref_celestial='ascendant' the temporary_relationships and compound_relationships fields come back null by design. An unrecognised name returns 400 (KeyError).
target_celestial	string	required	`sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutonorthtruenodenorthmeannode` Same value set as ref_celestial.
bhava_arudha_exceptions	boolean	optional
graha_arudha_exceptions	boolean	optional
nakshatras	string	optional

Full reference for this endpoint