Vedic Astrology

Birth chart, planet positions, Vimshottari dasha, upagrahas and ashtakavarga — all in one API. TOON format also supported (compressed for LLM prompts).

Endpoint

GET/astro?latitude=22.68&longitude=87.70&year=2008&month=5&day=9&hour=15&min=0

Full birth chart + dasha + upagrahas + ashtakavarga.

Base Parameters (Required)

Parameter	Type	Description	Example
latitude	float	Birth latitude (North +)	22.6823
longitude	float	Birth longitude (East +)	87.6992
year	int	Birth year	2008
month	int	Month (1-12)	5
day	int	Day (1-31)	9
hour	int	Hour (0-23)	15
min	int	Minute (0-59)	0

Optional: sec, dst_hour, dst_min, tz (e.g. +05:30 — auto if omitted).

Advanced

Parameter	Values	Default	Description
needs	comma-separated	full	Specific data modules
format	json · toon	json	Response format

needs — Data Modules

needs value	Data
graha	Planet positions
bhava	House cusps
lagna	Ascendant
panchanga	Tithi, nakshatra
varga D-charts	D1, D2, D3, D4, D7, D9, D10, D12, D16, D20, D24, D27, D30, D40, D45, D60
dasha / antardasha	Vimshottari mahadasha + antardasha + pratyantara
upagrahas	Shadow planets (Dhuma, Vyatipata…)
ashtakavarga	Bhinna + Sarva (337 points)

D-Charts (Divisional Charts)

All 16 vargas available — pass comma-separated in needs:

Chart	Name	Chart	Name
d1	Rashi	d12	Dwadasamsa
d2	Hora	d16	Shodasamsa
d3	Drekkana	d20	Vimsamsa
d4	Chaturthamsa	d24	Chaturvimsamsa
d7	Saptamsa	d27	Saptavimsamsa
d9	Navamsa	d30	Trimsamsa
d10	Dasamsa	d40	Khavedamsa
—	—	d45	Akshavedamsa
—	—	d60	Shashtiamsa

# Only 2 vargas needed:
curl "https://api.apimitra.in/astro?lat=28.61&lon=77.21&year=1990&month=8&day=15&hour=10&min=30&needs=graha,d9,d10,d60"

# Full (all 16 vargas):
curl "https://api.apimitra.in/astro?lat=28.61&lon=77.21&year=1990&month=8&day=15&hour=10&min=30&needs=full"

Example — Full Chart

curl "https://api.apimitra.in/astro?latitude=22.6823&longitude=87.6992&year=2008&month=5&day=9&hour=15&min=0"

{
  "chart": {
    "user": { "datetime": "2008-05-09 15:00:00", "timezone": "+05:30" },
    "graha": { "Su": { "longitude": 25.15, "rashi": 1 }, "Mo": { ... } },
    "bhava": { "1": { "longitude": 163.18 }, "2": { ... } },
    "lagna": { "Lg": { "rashi": 6, "nakshatra": { "name": "Uttara Phalguni" } } },
    "varga": { "D1": { ... }, "D9": { ... } },
    "dasha": { "periods": { "Ke": { "start": "2008-05-09" } } }
  },
  "vimshottari_dasha": {
    "mahadashas": [
      {
        "mahadasha": "Ke",
        "lord": "Ketu",
        "start": "2008-05-09",
        "end": "2015-05-09",
        "current": true,
        "antardashas": [ { "antardasha": "Ke", "pratyantaras": [ ... ] } ]
      }
    ]
  },
  "upagrahas": {
    "Dhuma": { "longitude": 158.48, "rashi": 6 },
    "Vyatipata": { ... }
  },
  "ashtakavarga": {
    "total_bindus": 337,
    "sarvashtakavarga": [ 28, 29, ... ]
  }
}

Example — Specific Needs (fast)

curl "https://api.apimitra.in/astro?latitude=28.61&longitude=77.21&year=1990&month=8&day=15&hour=10&min=30&needs=graha,bhava,d9"

Example — TOON Format (LLM-ready)

curl "https://api.apimitra.in/astro?latitude=19.07&longitude=72.87&year=2000&month=1&day=1&hour=0&min=0&format=toon"

chart:
  user:
    datetime: "2000-01-01 00:00:00"
    timezone: "+05:30"
  graha[9:]{longitude,latitude,speed,...}:
    Su: 255.77,0.0002,1.0194,...

note

TOON format — compact, schema-aware encoding for LLM prompts (3-5× smaller than JSON). Birth chart is static → 30-day cache — repeat requests instant (~0.2s).