GrahaJyoti API Reference

Vedic astrology REST API · v1.0.0. This page is generated from the live route registry, so it always matches the running API.

Basics

Base URL: https://grahajyoti.com/api/v1
Auth: send your key in the X-API-Key header. Create one at API Dashboard. Endpoints marked public need no key.
Plans: generous free tier, paid plans from $5/mo — see Pricing. Over quota returns 429.
Quick embed: drop a ready-made chart (D1/D9/Bhava Chalit/Dasha) into any page in one line — see the widget guide.
Format: JSON in, JSON out. Successful responses are wrapped in an envelope: { ok, endpoint, request_id, generated_at, input, data }.
Machine-readable: openapi.json · Swagger UI · catalog. For ChatGPT Custom GPT Actions (30-operation cap) import openapi.json?profile=actions.

curl -X POST "https://grahajyoti.com/api/v1/charts" \
  -H "X-API-Key: mkc_live_..." -H "Content-Type: application/json" \
  -d '{"dob":"1990-05-15","birth_time":"14:30","latitude":12.9716,"longitude":77.5946,"timezone":"Asia/Kolkata"}'

Endpoints

Meta: GET /health · GET /catalog · GET /openapi.json · GET /docs

Charts: POST /charts · POST /charts/dasha · POST /charts/strength · POST /charts/panchanga · POST /charts/varga · POST /charts/transit · POST /charts/manglik · POST /charts/retrograde · POST /charts/combustion · POST /charts/friendship · POST /charts/karaka · POST /charts/nakshatra · POST /charts/dignity · POST /charts/aspects

Kp: POST /kp/full · POST /kp/planets · POST /kp/cusps · POST /kp/nakshatra-nadi · POST /kp/significators · POST /kp/ruling-planets · POST /kp/dasha

Classical: POST /ashtakavarga · POST /bhava-chalit

Matchmaking: POST /match

Reference: GET /reference/nakshatras · GET /reference/rashis · GET /reference/planet-relations · GET /reference/friendship-rules · GET /reference/karaka-definitions

Utils: POST /utils/timezone-lookup

Charts

Birth-chart computations.

POST /charts API key post_charts

Kundli (lean by default): D1 + D9, planets, houses, panchanga, Bhava Chalit (true house cusps), and the mahadasha timeline. Add more vargas with charts=all or a list; deepen the dasha with dasha_depth; set bhava_chalit=false to skip.

Parameter	Type	Required	Description
`dob`	string	yes	e.g. 1990-05-15
`birth_time`	string	yes	e.g. 14:30
`latitude`	number	yes	e.g. 12.9716
`longitude`	number	yes	e.g. 77.5946
`timezone`	string	yes	e.g. Asia/Kolkata
`birth_place`	string	no	e.g. Bengaluru, India
`name`	string	no	e.g. Sample Subject
`ayanamsha`	enum: Lahiri \| Fagan \| Deluce \| Raman \| Ushashashi \| Krishnamurti \| Djwhalkhul \| Yukteshwar \| Jnbhasin \| Sassanian	no	e.g. Lahiri
`dasha_depth`	enum: maha \| antar \| pratyantar	no	Vimshottari dasha depth. maha=timeline only (smallest), antar=+antardasha, pratyantar=full tree (large). /charts & /kp/full default to maha; /charts/dasha & /kp/dasha default to antar. e.g. maha
`charts`	string \| array	no	Divisional charts to include on POST /charts, beyond D1 (always included). "all" for every varga, or a list like ["D9","D10"]. Default: D9. Ignored by other endpoints.
`bhava_chalit`	boolean	no	POST /charts only: include Bhava Chalit (true house cusps) in the response. Default true; set false to skip the upstream call for a faster response. e.g. 1

POST /charts/dasha API key post_charts_dasha

Vimshottari dasha. Default depth=antar (Maha + Antar). Use dasha_depth=maha for a small timeline or pratyantar for the full tree.

Parameter	Type	Required	Description
`dob`	string	yes	e.g. 1990-05-15
`birth_time`	string	yes	e.g. 14:30
`latitude`	number	yes	e.g. 12.9716
`longitude`	number	yes	e.g. 77.5946
`timezone`	string	yes	e.g. Asia/Kolkata
`birth_place`	string	no	e.g. Bengaluru, India
`name`	string	no	e.g. Sample Subject
`ayanamsha`	enum: Lahiri \| Fagan \| Deluce \| Raman \| Ushashashi \| Krishnamurti \| Djwhalkhul \| Yukteshwar \| Jnbhasin \| Sassanian	no	e.g. Lahiri
`dasha_depth`	enum: maha \| antar \| pratyantar	no	Vimshottari dasha depth. maha=timeline only (smallest), antar=+antardasha, pratyantar=full tree (large). /charts & /kp/full default to maha; /charts/dasha & /kp/dasha default to antar. e.g. maha
`charts`	string \| array	no	Divisional charts to include on POST /charts, beyond D1 (always included). "all" for every varga, or a list like ["D9","D10"]. Default: D9. Ignored by other endpoints.
`bhava_chalit`	boolean	no	POST /charts only: include Bhava Chalit (true house cusps) in the response. Default true; set false to skip the upstream call for a faster response. e.g. 1

POST /charts/strength API key post_charts_strength

Planetary strength analytics (Shad Bala etc.).

Parameter	Type	Required	Description
`dob`	string	yes	e.g. 1990-05-15
`birth_time`	string	yes	e.g. 14:30
`latitude`	number	yes	e.g. 12.9716
`longitude`	number	yes	e.g. 77.5946
`timezone`	string	yes	e.g. Asia/Kolkata
`birth_place`	string	no	e.g. Bengaluru, India
`name`	string	no	e.g. Sample Subject
`ayanamsha`	enum: Lahiri \| Fagan \| Deluce \| Raman \| Ushashashi \| Krishnamurti \| Djwhalkhul \| Yukteshwar \| Jnbhasin \| Sassanian	no	e.g. Lahiri
`dasha_depth`	enum: maha \| antar \| pratyantar	no	Vimshottari dasha depth. maha=timeline only (smallest), antar=+antardasha, pratyantar=full tree (large). /charts & /kp/full default to maha; /charts/dasha & /kp/dasha default to antar. e.g. maha
`charts`	string \| array	no	Divisional charts to include on POST /charts, beyond D1 (always included). "all" for every varga, or a list like ["D9","D10"]. Default: D9. Ignored by other endpoints.
`bhava_chalit`	boolean	no	POST /charts only: include Bhava Chalit (true house cusps) in the response. Default true; set false to skip the upstream call for a faster response. e.g. 1

POST /charts/panchanga API key post_charts_panchanga

Panchanga: Tithi, Nakshatra, Yoga, Karana, Vara.

Parameter	Type	Required	Description
`dob`	string	yes	e.g. 1990-05-15
`birth_time`	string	yes	e.g. 14:30
`latitude`	number	yes	e.g. 12.9716
`longitude`	number	yes	e.g. 77.5946
`timezone`	string	yes	e.g. Asia/Kolkata
`birth_place`	string	no	e.g. Bengaluru, India
`name`	string	no	e.g. Sample Subject
`ayanamsha`	enum: Lahiri \| Fagan \| Deluce \| Raman \| Ushashashi \| Krishnamurti \| Djwhalkhul \| Yukteshwar \| Jnbhasin \| Sassanian	no	e.g. Lahiri
`dasha_depth`	enum: maha \| antar \| pratyantar	no	Vimshottari dasha depth. maha=timeline only (smallest), antar=+antardasha, pratyantar=full tree (large). /charts & /kp/full default to maha; /charts/dasha & /kp/dasha default to antar. e.g. maha
`charts`	string \| array	no	Divisional charts to include on POST /charts, beyond D1 (always included). "all" for every varga, or a list like ["D9","D10"]. Default: D9. Ignored by other endpoints.
`bhava_chalit`	boolean	no	POST /charts only: include Bhava Chalit (true house cusps) in the response. Default true; set false to skip the upstream call for a faster response. e.g. 1

POST /charts/varga API key post_charts_varga

A single varga (D1, D2, D3, D4, D7, D9, D10, D12, D16, D20, D24, D27, D30, D40, D45, D60). Pass division in body.

Parameter	Type	Required	Description
`dob`	string	yes	e.g. 1990-05-15
`birth_time`	string	yes	e.g. 14:30
`latitude`	number	yes	e.g. 12.9716
`longitude`	number	yes	e.g. 77.5946
`timezone`	string	yes	e.g. Asia/Kolkata
`birth_place`	string	no	e.g. Bengaluru, India
`name`	string	no	e.g. Sample Subject
`ayanamsha`	enum: Lahiri \| Fagan \| Deluce \| Raman \| Ushashashi \| Krishnamurti \| Djwhalkhul \| Yukteshwar \| Jnbhasin \| Sassanian	no	e.g. Lahiri
`dasha_depth`	enum: maha \| antar \| pratyantar	no	Vimshottari dasha depth. maha=timeline only (smallest), antar=+antardasha, pratyantar=full tree (large). /charts & /kp/full default to maha; /charts/dasha & /kp/dasha default to antar. e.g. maha
`charts`	string \| array	no	Divisional charts to include on POST /charts, beyond D1 (always included). "all" for every varga, or a list like ["D9","D10"]. Default: D9. Ignored by other endpoints.
`bhava_chalit`	boolean	no	POST /charts only: include Bhava Chalit (true house cusps) in the response. Default true; set false to skip the upstream call for a faster response. e.g. 1
`division`	enum: D1 \| D2 \| D3 \| D4 \| D7 \| D9 \| D10 \| D12 \| D16 \| D20 \| D24 \| D27 \| D30 \| D40 \| D45 \| D60	yes	e.g. D9

POST /charts/transit API key post_charts_transit

Current-moment transit chart for a given location.

Parameter	Type	Required	Description
`dob`	string	yes	e.g. 1990-05-15
`birth_time`	string	yes	e.g. 14:30
`latitude`	number	yes	e.g. 12.9716
`longitude`	number	yes	e.g. 77.5946
`timezone`	string	yes	e.g. Asia/Kolkata
`birth_place`	string	no	e.g. Bengaluru, India
`name`	string	no	e.g. Sample Subject
`ayanamsha`	enum: Lahiri \| Fagan \| Deluce \| Raman \| Ushashashi \| Krishnamurti \| Djwhalkhul \| Yukteshwar \| Jnbhasin \| Sassanian	no	e.g. Lahiri
`dasha_depth`	enum: maha \| antar \| pratyantar	no	Vimshottari dasha depth. maha=timeline only (smallest), antar=+antardasha, pratyantar=full tree (large). /charts & /kp/full default to maha; /charts/dasha & /kp/dasha default to antar. e.g. maha
`charts`	string \| array	no	Divisional charts to include on POST /charts, beyond D1 (always included). "all" for every varga, or a list like ["D9","D10"]. Default: D9. Ignored by other endpoints.
`bhava_chalit`	boolean	no	POST /charts only: include Bhava Chalit (true house cusps) in the response. Default true; set false to skip the upstream call for a faster response. e.g. 1

POST /charts/manglik API key post_charts_manglik

Manglik (Kuja) dosha analysis from Lagna and Moon.

Parameter	Type	Required	Description
`dob`	string	yes	e.g. 1990-05-15
`birth_time`	string	yes	e.g. 14:30
`latitude`	number	yes	e.g. 12.9716
`longitude`	number	yes	e.g. 77.5946
`timezone`	string	yes	e.g. Asia/Kolkata
`birth_place`	string	no	e.g. Bengaluru, India
`name`	string	no	e.g. Sample Subject
`ayanamsha`	enum: Lahiri \| Fagan \| Deluce \| Raman \| Ushashashi \| Krishnamurti \| Djwhalkhul \| Yukteshwar \| Jnbhasin \| Sassanian	no	e.g. Lahiri
`dasha_depth`	enum: maha \| antar \| pratyantar	no	Vimshottari dasha depth. maha=timeline only (smallest), antar=+antardasha, pratyantar=full tree (large). /charts & /kp/full default to maha; /charts/dasha & /kp/dasha default to antar. e.g. maha
`charts`	string \| array	no	Divisional charts to include on POST /charts, beyond D1 (always included). "all" for every varga, or a list like ["D9","D10"]. Default: D9. Ignored by other endpoints.
`bhava_chalit`	boolean	no	POST /charts only: include Bhava Chalit (true house cusps) in the response. Default true; set false to skip the upstream call for a faster response. e.g. 1

POST /charts/retrograde API key post_charts_retrograde

Retrograde planet detection at birth moment.

Parameter	Type	Required	Description
`dob`	string	yes	e.g. 1990-05-15
`birth_time`	string	yes	e.g. 14:30
`latitude`	number	yes	e.g. 12.9716
`longitude`	number	yes	e.g. 77.5946
`timezone`	string	yes	e.g. Asia/Kolkata
`birth_place`	string	no	e.g. Bengaluru, India
`name`	string	no	e.g. Sample Subject
`ayanamsha`	enum: Lahiri \| Fagan \| Deluce \| Raman \| Ushashashi \| Krishnamurti \| Djwhalkhul \| Yukteshwar \| Jnbhasin \| Sassanian	no	e.g. Lahiri
`dasha_depth`	enum: maha \| antar \| pratyantar	no	Vimshottari dasha depth. maha=timeline only (smallest), antar=+antardasha, pratyantar=full tree (large). /charts & /kp/full default to maha; /charts/dasha & /kp/dasha default to antar. e.g. maha
`charts`	string \| array	no	Divisional charts to include on POST /charts, beyond D1 (always included). "all" for every varga, or a list like ["D9","D10"]. Default: D9. Ignored by other endpoints.
`bhava_chalit`	boolean	no	POST /charts only: include Bhava Chalit (true house cusps) in the response. Default true; set false to skip the upstream call for a faster response. e.g. 1

POST /charts/combustion API key post_charts_combustion

Combust (asta) planet detection.

Parameter	Type	Required	Description
`dob`	string	yes	e.g. 1990-05-15
`birth_time`	string	yes	e.g. 14:30
`latitude`	number	yes	e.g. 12.9716
`longitude`	number	yes	e.g. 77.5946
`timezone`	string	yes	e.g. Asia/Kolkata
`birth_place`	string	no	e.g. Bengaluru, India
`name`	string	no	e.g. Sample Subject
`ayanamsha`	enum: Lahiri \| Fagan \| Deluce \| Raman \| Ushashashi \| Krishnamurti \| Djwhalkhul \| Yukteshwar \| Jnbhasin \| Sassanian	no	e.g. Lahiri
`dasha_depth`	enum: maha \| antar \| pratyantar	no	Vimshottari dasha depth. maha=timeline only (smallest), antar=+antardasha, pratyantar=full tree (large). /charts & /kp/full default to maha; /charts/dasha & /kp/dasha default to antar. e.g. maha
`charts`	string \| array	no	Divisional charts to include on POST /charts, beyond D1 (always included). "all" for every varga, or a list like ["D9","D10"]. Default: D9. Ignored by other endpoints.
`bhava_chalit`	boolean	no	POST /charts only: include Bhava Chalit (true house cusps) in the response. Default true; set false to skip the upstream call for a faster response. e.g. 1

POST /charts/friendship API key post_charts_friendship

Permanent + temporary planetary friendship tables (JSON).

Parameter	Type	Required	Description
`dob`	string	yes	e.g. 1990-05-15
`birth_time`	string	yes	e.g. 14:30
`latitude`	number	yes	e.g. 12.9716
`longitude`	number	yes	e.g. 77.5946
`timezone`	string	yes	e.g. Asia/Kolkata
`birth_place`	string	no	e.g. Bengaluru, India
`name`	string	no	e.g. Sample Subject
`ayanamsha`	enum: Lahiri \| Fagan \| Deluce \| Raman \| Ushashashi \| Krishnamurti \| Djwhalkhul \| Yukteshwar \| Jnbhasin \| Sassanian	no	e.g. Lahiri
`dasha_depth`	enum: maha \| antar \| pratyantar	no	Vimshottari dasha depth. maha=timeline only (smallest), antar=+antardasha, pratyantar=full tree (large). /charts & /kp/full default to maha; /charts/dasha & /kp/dasha default to antar. e.g. maha
`charts`	string \| array	no	Divisional charts to include on POST /charts, beyond D1 (always included). "all" for every varga, or a list like ["D9","D10"]. Default: D9. Ignored by other endpoints.
`bhava_chalit`	boolean	no	POST /charts only: include Bhava Chalit (true house cusps) in the response. Default true; set false to skip the upstream call for a faster response. e.g. 1

POST /charts/karaka API key post_charts_karaka

Chara Karaka role assignment + definitions.

Parameter	Type	Required	Description
`dob`	string	yes	e.g. 1990-05-15
`birth_time`	string	yes	e.g. 14:30
`latitude`	number	yes	e.g. 12.9716
`longitude`	number	yes	e.g. 77.5946
`timezone`	string	yes	e.g. Asia/Kolkata
`birth_place`	string	no	e.g. Bengaluru, India
`name`	string	no	e.g. Sample Subject
`ayanamsha`	enum: Lahiri \| Fagan \| Deluce \| Raman \| Ushashashi \| Krishnamurti \| Djwhalkhul \| Yukteshwar \| Jnbhasin \| Sassanian	no	e.g. Lahiri
`dasha_depth`	enum: maha \| antar \| pratyantar	no	Vimshottari dasha depth. maha=timeline only (smallest), antar=+antardasha, pratyantar=full tree (large). /charts & /kp/full default to maha; /charts/dasha & /kp/dasha default to antar. e.g. maha
`charts`	string \| array	no	Divisional charts to include on POST /charts, beyond D1 (always included). "all" for every varga, or a list like ["D9","D10"]. Default: D9. Ignored by other endpoints.
`bhava_chalit`	boolean	no	POST /charts only: include Bhava Chalit (true house cusps) in the response. Default true; set false to skip the upstream call for a faster response. e.g. 1

POST /charts/nakshatra API key post_charts_nakshatra

Per-planet (and Lagna) Nakshatra + Pada + lord + deity.

Parameter	Type	Required	Description
`dob`	string	yes	e.g. 1990-05-15
`birth_time`	string	yes	e.g. 14:30
`latitude`	number	yes	e.g. 12.9716
`longitude`	number	yes	e.g. 77.5946
`timezone`	string	yes	e.g. Asia/Kolkata
`birth_place`	string	no	e.g. Bengaluru, India
`name`	string	no	e.g. Sample Subject
`ayanamsha`	enum: Lahiri \| Fagan \| Deluce \| Raman \| Ushashashi \| Krishnamurti \| Djwhalkhul \| Yukteshwar \| Jnbhasin \| Sassanian	no	e.g. Lahiri
`dasha_depth`	enum: maha \| antar \| pratyantar	no	Vimshottari dasha depth. maha=timeline only (smallest), antar=+antardasha, pratyantar=full tree (large). /charts & /kp/full default to maha; /charts/dasha & /kp/dasha default to antar. e.g. maha
`charts`	string \| array	no	Divisional charts to include on POST /charts, beyond D1 (always included). "all" for every varga, or a list like ["D9","D10"]. Default: D9. Ignored by other endpoints.
`bhava_chalit`	boolean	no	POST /charts only: include Bhava Chalit (true house cusps) in the response. Default true; set false to skip the upstream call for a faster response. e.g. 1

POST /charts/dignity API key post_charts_dignity

Per-planet dignity: exaltation/own/moola-trikona/friend/neutral/enemy/debilitation with points.

Parameter	Type	Required	Description
`dob`	string	yes	e.g. 1990-05-15
`birth_time`	string	yes	e.g. 14:30
`latitude`	number	yes	e.g. 12.9716
`longitude`	number	yes	e.g. 77.5946
`timezone`	string	yes	e.g. Asia/Kolkata
`birth_place`	string	no	e.g. Bengaluru, India
`name`	string	no	e.g. Sample Subject
`ayanamsha`	enum: Lahiri \| Fagan \| Deluce \| Raman \| Ushashashi \| Krishnamurti \| Djwhalkhul \| Yukteshwar \| Jnbhasin \| Sassanian	no	e.g. Lahiri
`dasha_depth`	enum: maha \| antar \| pratyantar	no	Vimshottari dasha depth. maha=timeline only (smallest), antar=+antardasha, pratyantar=full tree (large). /charts & /kp/full default to maha; /charts/dasha & /kp/dasha default to antar. e.g. maha
`charts`	string \| array	no	Divisional charts to include on POST /charts, beyond D1 (always included). "all" for every varga, or a list like ["D9","D10"]. Default: D9. Ignored by other endpoints.
`bhava_chalit`	boolean	no	POST /charts only: include Bhava Chalit (true house cusps) in the response. Default true; set false to skip the upstream call for a faster response. e.g. 1

POST /charts/aspects API key post_charts_aspects

Graha Drishti — every planet aspects the 7th; Mars/Jupiter/Saturn/Rahu/Ketu have specials.

Parameter	Type	Required	Description
`dob`	string	yes	e.g. 1990-05-15
`birth_time`	string	yes	e.g. 14:30
`latitude`	number	yes	e.g. 12.9716
`longitude`	number	yes	e.g. 77.5946
`timezone`	string	yes	e.g. Asia/Kolkata
`birth_place`	string	no	e.g. Bengaluru, India
`name`	string	no	e.g. Sample Subject
`ayanamsha`	enum: Lahiri \| Fagan \| Deluce \| Raman \| Ushashashi \| Krishnamurti \| Djwhalkhul \| Yukteshwar \| Jnbhasin \| Sassanian	no	e.g. Lahiri
`dasha_depth`	enum: maha \| antar \| pratyantar	no	Vimshottari dasha depth. maha=timeline only (smallest), antar=+antardasha, pratyantar=full tree (large). /charts & /kp/full default to maha; /charts/dasha & /kp/dasha default to antar. e.g. maha
`charts`	string \| array	no	Divisional charts to include on POST /charts, beyond D1 (always included). "all" for every varga, or a list like ["D9","D10"]. Default: D9. Ignored by other endpoints.
`bhava_chalit`	boolean	no	POST /charts only: include Bhava Chalit (true house cusps) in the response. Default true; set false to skip the upstream call for a faster response. e.g. 1

Kp

Krishnamurti Paddhati / Nakshatra-Nadi.

POST /kp/full API key post_kp_full

Complete KP payload: planets + cusps + significators + ruling planets + dasha. Dasha defaults to the mahadasha timeline; deepen with dasha_depth=antar|pratyantar.

Parameter	Type	Required	Description
`dob`	string	yes	e.g. 1990-05-15
`birth_time`	string	yes	e.g. 14:30
`latitude`	number	yes	e.g. 12.9716
`longitude`	number	yes	e.g. 77.5946
`timezone`	string	yes	e.g. Asia/Kolkata
`birth_place`	string	no	e.g. Bengaluru, India
`name`	string	no	e.g. Sample Subject
`ayanamsha`	enum: Lahiri \| Fagan \| Deluce \| Raman \| Ushashashi \| Krishnamurti \| Djwhalkhul \| Yukteshwar \| Jnbhasin \| Sassanian	no	e.g. Lahiri
`dasha_depth`	enum: maha \| antar \| pratyantar	no	Vimshottari dasha depth. maha=timeline only (smallest), antar=+antardasha, pratyantar=full tree (large). /charts & /kp/full default to maha; /charts/dasha & /kp/dasha default to antar. e.g. maha
`charts`	string \| array	no	Divisional charts to include on POST /charts, beyond D1 (always included). "all" for every varga, or a list like ["D9","D10"]. Default: D9. Ignored by other endpoints.
`bhava_chalit`	boolean	no	POST /charts only: include Bhava Chalit (true house cusps) in the response. Default true; set false to skip the upstream call for a faster response. e.g. 1
`house_system`	string	no	e.g. P
`node_type`	enum: true \| mean	no	e.g. true

POST /kp/planets API key post_kp_planets

KP planets table with full sub-lord chain.

Parameter	Type	Required	Description
`dob`	string	yes	e.g. 1990-05-15
`birth_time`	string	yes	e.g. 14:30
`latitude`	number	yes	e.g. 12.9716
`longitude`	number	yes	e.g. 77.5946
`timezone`	string	yes	e.g. Asia/Kolkata
`birth_place`	string	no	e.g. Bengaluru, India
`name`	string	no	e.g. Sample Subject
`ayanamsha`	enum: Lahiri \| Fagan \| Deluce \| Raman \| Ushashashi \| Krishnamurti \| Djwhalkhul \| Yukteshwar \| Jnbhasin \| Sassanian	no	e.g. Lahiri
`dasha_depth`	enum: maha \| antar \| pratyantar	no	Vimshottari dasha depth. maha=timeline only (smallest), antar=+antardasha, pratyantar=full tree (large). /charts & /kp/full default to maha; /charts/dasha & /kp/dasha default to antar. e.g. maha
`charts`	string \| array	no	Divisional charts to include on POST /charts, beyond D1 (always included). "all" for every varga, or a list like ["D9","D10"]. Default: D9. Ignored by other endpoints.
`bhava_chalit`	boolean	no	POST /charts only: include Bhava Chalit (true house cusps) in the response. Default true; set false to skip the upstream call for a faster response. e.g. 1
`house_system`	string	no	e.g. P
`node_type`	enum: true \| mean	no	e.g. true

POST /kp/cusps API key post_kp_cusps

KP house cusps with full sub-lord chain.

Parameter	Type	Required	Description
`dob`	string	yes	e.g. 1990-05-15
`birth_time`	string	yes	e.g. 14:30
`latitude`	number	yes	e.g. 12.9716
`longitude`	number	yes	e.g. 77.5946
`timezone`	string	yes	e.g. Asia/Kolkata
`birth_place`	string	no	e.g. Bengaluru, India
`name`	string	no	e.g. Sample Subject
`ayanamsha`	enum: Lahiri \| Fagan \| Deluce \| Raman \| Ushashashi \| Krishnamurti \| Djwhalkhul \| Yukteshwar \| Jnbhasin \| Sassanian	no	e.g. Lahiri
`dasha_depth`	enum: maha \| antar \| pratyantar	no	Vimshottari dasha depth. maha=timeline only (smallest), antar=+antardasha, pratyantar=full tree (large). /charts & /kp/full default to maha; /charts/dasha & /kp/dasha default to antar. e.g. maha
`charts`	string \| array	no	Divisional charts to include on POST /charts, beyond D1 (always included). "all" for every varga, or a list like ["D9","D10"]. Default: D9. Ignored by other endpoints.
`bhava_chalit`	boolean	no	POST /charts only: include Bhava Chalit (true house cusps) in the response. Default true; set false to skip the upstream call for a faster response. e.g. 1
`house_system`	string	no	e.g. P
`node_type`	enum: true \| mean	no	e.g. true

POST /kp/nakshatra-nadi API key post_kp_nakshatra_nadi

Slim per-body Nakshatra-Nadi rows (planets + cusps).

Parameter	Type	Required	Description
`dob`	string	yes	e.g. 1990-05-15
`birth_time`	string	yes	e.g. 14:30
`latitude`	number	yes	e.g. 12.9716
`longitude`	number	yes	e.g. 77.5946
`timezone`	string	yes	e.g. Asia/Kolkata
`birth_place`	string	no	e.g. Bengaluru, India
`name`	string	no	e.g. Sample Subject
`ayanamsha`	enum: Lahiri \| Fagan \| Deluce \| Raman \| Ushashashi \| Krishnamurti \| Djwhalkhul \| Yukteshwar \| Jnbhasin \| Sassanian	no	e.g. Lahiri
`dasha_depth`	enum: maha \| antar \| pratyantar	no	Vimshottari dasha depth. maha=timeline only (smallest), antar=+antardasha, pratyantar=full tree (large). /charts & /kp/full default to maha; /charts/dasha & /kp/dasha default to antar. e.g. maha
`charts`	string \| array	no	Divisional charts to include on POST /charts, beyond D1 (always included). "all" for every varga, or a list like ["D9","D10"]. Default: D9. Ignored by other endpoints.
`bhava_chalit`	boolean	no	POST /charts only: include Bhava Chalit (true house cusps) in the response. Default true; set false to skip the upstream call for a faster response. e.g. 1
`house_system`	string	no	e.g. P
`node_type`	enum: true \| mean	no	e.g. true

POST /kp/significators API key post_kp_significators

KP 4-step significators per house and per planet.

Parameter	Type	Required	Description
`dob`	string	yes	e.g. 1990-05-15
`birth_time`	string	yes	e.g. 14:30
`latitude`	number	yes	e.g. 12.9716
`longitude`	number	yes	e.g. 77.5946
`timezone`	string	yes	e.g. Asia/Kolkata
`birth_place`	string	no	e.g. Bengaluru, India
`name`	string	no	e.g. Sample Subject
`ayanamsha`	enum: Lahiri \| Fagan \| Deluce \| Raman \| Ushashashi \| Krishnamurti \| Djwhalkhul \| Yukteshwar \| Jnbhasin \| Sassanian	no	e.g. Lahiri
`dasha_depth`	enum: maha \| antar \| pratyantar	no	Vimshottari dasha depth. maha=timeline only (smallest), antar=+antardasha, pratyantar=full tree (large). /charts & /kp/full default to maha; /charts/dasha & /kp/dasha default to antar. e.g. maha
`charts`	string \| array	no	Divisional charts to include on POST /charts, beyond D1 (always included). "all" for every varga, or a list like ["D9","D10"]. Default: D9. Ignored by other endpoints.
`bhava_chalit`	boolean	no	POST /charts only: include Bhava Chalit (true house cusps) in the response. Default true; set false to skip the upstream call for a faster response. e.g. 1
`house_system`	string	no	e.g. P
`node_type`	enum: true \| mean	no	e.g. true

POST /kp/ruling-planets API key post_kp_ruling_planets

KP ruling planets at the birth moment.

Parameter	Type	Required	Description
`dob`	string	yes	e.g. 1990-05-15
`birth_time`	string	yes	e.g. 14:30
`latitude`	number	yes	e.g. 12.9716
`longitude`	number	yes	e.g. 77.5946
`timezone`	string	yes	e.g. Asia/Kolkata
`birth_place`	string	no	e.g. Bengaluru, India
`name`	string	no	e.g. Sample Subject
`ayanamsha`	enum: Lahiri \| Fagan \| Deluce \| Raman \| Ushashashi \| Krishnamurti \| Djwhalkhul \| Yukteshwar \| Jnbhasin \| Sassanian	no	e.g. Lahiri
`dasha_depth`	enum: maha \| antar \| pratyantar	no	Vimshottari dasha depth. maha=timeline only (smallest), antar=+antardasha, pratyantar=full tree (large). /charts & /kp/full default to maha; /charts/dasha & /kp/dasha default to antar. e.g. maha
`charts`	string \| array	no	Divisional charts to include on POST /charts, beyond D1 (always included). "all" for every varga, or a list like ["D9","D10"]. Default: D9. Ignored by other endpoints.
`bhava_chalit`	boolean	no	POST /charts only: include Bhava Chalit (true house cusps) in the response. Default true; set false to skip the upstream call for a faster response. e.g. 1
`house_system`	string	no	e.g. P
`node_type`	enum: true \| mean	no	e.g. true

POST /kp/dasha API key post_kp_dasha

Vimshottari dasha under the chosen KP ayanamsha. Default depth=antar; set dasha_depth=maha|pratyantar.

Parameter	Type	Required	Description
`dob`	string	yes	e.g. 1990-05-15
`birth_time`	string	yes	e.g. 14:30
`latitude`	number	yes	e.g. 12.9716
`longitude`	number	yes	e.g. 77.5946
`timezone`	string	yes	e.g. Asia/Kolkata
`birth_place`	string	no	e.g. Bengaluru, India
`name`	string	no	e.g. Sample Subject
`ayanamsha`	enum: Lahiri \| Fagan \| Deluce \| Raman \| Ushashashi \| Krishnamurti \| Djwhalkhul \| Yukteshwar \| Jnbhasin \| Sassanian	no	e.g. Lahiri
`dasha_depth`	enum: maha \| antar \| pratyantar	no	Vimshottari dasha depth. maha=timeline only (smallest), antar=+antardasha, pratyantar=full tree (large). /charts & /kp/full default to maha; /charts/dasha & /kp/dasha default to antar. e.g. maha
`charts`	string \| array	no	Divisional charts to include on POST /charts, beyond D1 (always included). "all" for every varga, or a list like ["D9","D10"]. Default: D9. Ignored by other endpoints.
`bhava_chalit`	boolean	no	POST /charts only: include Bhava Chalit (true house cusps) in the response. Default true; set false to skip the upstream call for a faster response. e.g. 1
`house_system`	string	no	e.g. P
`node_type`	enum: true \| mean	no	e.g. true

Classical

Ashtakavarga, Bhava-Chalit (upstream-backed).

POST /ashtakavarga API key post_ashtakavarga

Ashtakavarga BAV/SAV (calls upstream; falls back to local).

Parameter	Type	Required	Description
`dob`	string	yes	e.g. 1990-05-15
`birth_time`	string	yes	e.g. 14:30
`latitude`	number	yes	e.g. 12.9716
`longitude`	number	yes	e.g. 77.5946
`timezone`	string	yes	e.g. Asia/Kolkata
`birth_place`	string	no	e.g. Bengaluru, India
`name`	string	no	e.g. Sample Subject
`ayanamsha`	enum: Lahiri \| Fagan \| Deluce \| Raman \| Ushashashi \| Krishnamurti \| Djwhalkhul \| Yukteshwar \| Jnbhasin \| Sassanian	no	e.g. Lahiri
`dasha_depth`	enum: maha \| antar \| pratyantar	no	Vimshottari dasha depth. maha=timeline only (smallest), antar=+antardasha, pratyantar=full tree (large). /charts & /kp/full default to maha; /charts/dasha & /kp/dasha default to antar. e.g. maha
`charts`	string \| array	no	Divisional charts to include on POST /charts, beyond D1 (always included). "all" for every varga, or a list like ["D9","D10"]. Default: D9. Ignored by other endpoints.
`bhava_chalit`	boolean	no	POST /charts only: include Bhava Chalit (true house cusps) in the response. Default true; set false to skip the upstream call for a faster response. e.g. 1

POST /bhava-chalit API key post_bhava_chalit

Bhava Chalit (cuspal strength + true house positions) via upstream.

Parameter	Type	Required	Description
`dob`	string	yes	e.g. 1990-05-15
`birth_time`	string	yes	e.g. 14:30
`latitude`	number	yes	e.g. 12.9716
`longitude`	number	yes	e.g. 77.5946
`timezone`	string	yes	e.g. Asia/Kolkata
`birth_place`	string	no	e.g. Bengaluru, India
`name`	string	no	e.g. Sample Subject
`ayanamsha`	enum: Lahiri \| Fagan \| Deluce \| Raman \| Ushashashi \| Krishnamurti \| Djwhalkhul \| Yukteshwar \| Jnbhasin \| Sassanian	no	e.g. Lahiri
`dasha_depth`	enum: maha \| antar \| pratyantar	no	Vimshottari dasha depth. maha=timeline only (smallest), antar=+antardasha, pratyantar=full tree (large). /charts & /kp/full default to maha; /charts/dasha & /kp/dasha default to antar. e.g. maha
`charts`	string \| array	no	Divisional charts to include on POST /charts, beyond D1 (always included). "all" for every varga, or a list like ["D9","D10"]. Default: D9. Ignored by other endpoints.
`bhava_chalit`	boolean	no	POST /charts only: include Bhava Chalit (true house cusps) in the response. Default true; set false to skip the upstream call for a faster response. e.g. 1
`house_system`	string	no	e.g. P
`node_type`	enum: true \| mean	no	e.g. true

Matchmaking

Gun Milan / Ashta-koota.

POST /match API key post_match

Gun-Milan / Ashta-koota compatibility (calls the same upstream as /match-making.php).

Parameter	Type	Required	Description
`method`	enum: North \| South	no	e.g. North
`boy`	object	yes
`girl`	object	yes

Reference

Static reference tables (no birth chart needed).

GET /reference/nakshatras public get_reference_nakshatras

All 27 Nakshatras with lord, deity, longitude span.

No parameters.

GET /reference/rashis public get_reference_rashis

All 12 zodiac signs with lord, element, mode, gender, parity.

No parameters.

GET /reference/planet-relations public get_reference_planet_relations

Planet exaltation, debilitation, moola-trikona, and natural friendship/enemy/neutral relations.

No parameters.

GET /reference/friendship-rules public get_reference_friendship_rules

Permanent friendship table + temporary rule + compound friendship classification.

No parameters.

GET /reference/karaka-definitions public get_reference_karaka_definitions

Chara Karaka role definitions (Atma, Amatya, Bhratru, Matru, Putra, Gnati, Dara).

No parameters.

Utils

Helpers — timezone lookup etc.

POST /utils/timezone-lookup API key post_utils_timezone_lookup

Latitude/longitude → IANA timezone (Azure Maps).

Parameter	Type	Required	Description
`latitude`	number	yes	e.g. 12.9716
`longitude`	number	yes	e.g. 77.5946