Chart Basics
A Kundli describes where each planet sits at the moment of birth. In the DevDarsha sidereal model, positions are measured against the fixed stars using the active ayanamsa, and houses follow the whole-sign system. Every example here uses the sample birth of Aarav Sharma, born 1990-08-15 at 10:30 in Kolkata.
Use this to understand the chart fields and the divisional endpoint’s scope. See Documentation for the exact schema and the full field list.
Kundli Fields
The Kundli payload centers on three groups of data:
- Planets: each graha with its sign, house, and longitude. This is the backbone of any chart display.
- Houses: the twelve bhavas and the sign occupying each, anchored by the ascendant (lagna).
- Signs: the sidereal sign for each planet and for the ascendant, used to label a chart wheel or table.
The meta.calculation block reports the zodiac, ayanamsa, and house system so your UI can show which conventions produced the chart.
Divisional Charts (D1 + D9 only)
Divisional charts (vargas) subdivide each sign to examine specific themes. The birth chart itself is the D1 (Rashi). The D9 (Navamsa) is the most widely used derived chart. The divisional endpoint currently supports only these two vargas: D1 and D9. Requests for any other varga return an unsupported-varga error rather than an approximate chart.
If your product roadmap assumes charts beyond D1 and D9, gate those features until support is announced. Building only on D1 and D9 keeps your integration aligned with what the endpoint actually returns.
How to Use the Divisional Endpoint
Call the divisional endpoint with the same birth input, and request D9 to obtain the Navamsa:
curl -X POST https://horoscope.devdarsha.com/v1/divisional/D9 \
-H "content-type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{"date":"1990-08-15","time":"10:30","city":"Kolkata"}'Read the sign and house placements from the returned chart the same way you read the D1. Presenting D1 and D9 side by side is a common pattern for birth-profile screens.
Display Tips
Keep the ascendant visible — it orients the whole chart. Label each chart with the varga it represents so users are never unsure which chart they are reading. Treat any field as optional in your rendering so a plan-gated or absent value never breaks the layout.