Natal Chart — Janam Kundali

Calculate a complete Vedic natal chart using Swiss Ephemeris. Returns planet positions in sidereal zodiac, house placements (whole sign), ascendant, nakshatra data, Avakahada Chakra table, and optional classical Vedic interpretation for each planet placement. Also known as Janam Kundali or Janma Kundali. Returns planets (Grahas), houses (Bhavas), ascendant (Lagna), nakshatra positions, and avakahada table.

Endpoint

POST /v1/astro/natal

Request parameters

Field	Type	Required	Description
location	string \| null	No	City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.
name	string	No	Person name associated with the birth record
date	string	Yes	Birth date in YYYY-MM-DD format
time	string \| null	No	Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.
latitude	number \| null	No	Latitude. Required if location not provided.
longitude	number \| null	No	Longitude. Required if location not provided.
timezone	string \| null	No	IANA timezone. Required if location not provided.
ayanamsa	string	No	Sidereal ayanamsa mode used in calculations
include_interpretation	boolean	No	Whether to include planet-in-house interpretation layer

Example request

curl
Python
TypeScript

curl -X POST "https://api.asterwise.com/v1/astro/natal" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1985-11-12","time":"06:45","latitude":19.076,"longitude":72.8777,"timezone":"Asia/Kolkata"}'

import asterwise
from asterwise.api.astrology_api import AstrologyApi
from asterwise.models.natal_request import NatalRequest

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

request = NatalRequest(
    date="1985-11-12",
    time="06:45",
    latitude=19.076,
    longitude=72.8777,
    timezone="Asia/Kolkata",
)

with asterwise.ApiClient(configuration) as client:
    api = AstrologyApi(client)
    result = api.natal_chart(natal_request=request)
    print(result)

import { createClient, createConfig, natalChart } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await natalChart({
  client,
  body: {
      "date": "1985-11-12",
      "time": "06:45",
      "latitude": 19.076,
      "longitude": 72.8777,
      "timezone": "Asia/Kolkata"
  },
});

console.log(result.data);

Example response

{
  "success": true,
  "message": "success",
  "data": {
    "planets": [
      {
        "planet": "Sun",
        "sign": "Tula",
        "sign_num": 6,
        "degree": 205.93708808501702,
        "nakshatra": "Vishakha",
        "nakshatra_pada": 2,
        "is_retrograde": false,
        "is_combust": false,
        "is_deep_combust": false,
        "house": 1,
        "rasi_house": 1,
        "bhava_chalit_house": 1,
        "house_system_note": null
      },
      {
        "planet": "Moon",
        "sign": "Tula",
        "sign_num": 6,
        "degree": 198.17867014282342,
        "nakshatra": "Swati",
        "nakshatra_pada": 4,
        "is_retrograde": false,
        "is_combust": true,
        "is_deep_combust": false,
        "house": 1,
        "rasi_house": 1,
        "bhava_chalit_house": 1,
        "house_system_note": null
      },
      "... and 7 more items"
    ],
    "houses": [
      {
        "house": 1,
        "sign": "Tula",
        "sign_num": 6,
        "degree": 205.29805779141861
      },
      {
        "house": 2,
        "sign": "Vrischika",
        "sign_num": 7,
        "degree": 234.5126145915632
      },
      "... and 10 more items"
    ],
    "ascendant": 205.29805779141861,
    "ascendant_sign": "Tula",
    "ayanamsa_value": 23.659623932291197,
    "ayanamsa_used": "lahiri",
    "birth_time_provided": true,
    "interpretation": null,
    "ascendant_sign_interpretation": null,
    "moon_sign": "Tula",
    "moon_nakshatra": "Swati",
    "moon_sign_interpretation": null,
    "moon_nakshatra_interpretation": null,
    "avakahada": {
      "nakshatra": "Swati",
      "nakshatra_lord": "Rahu",
      "charan": 4,
      "rashi": "Tula",
      "rashi_lord": "Venus",
      "varna": "Shudra",
      "vashya": "Nara",
      "yoni": "Buffalo",
      "gana": "Deva",
      "nadi": "Antya",
      "paya": "Silver",
      "ascendant": "Tula",
      "ascendant_lord": "Venus",
      "sun_sign": "Tula",
      "sun_sign_lord": "Venus"
    },
    "bhava_madhya": [
      {
        "house": 1,
        "sign": "Tula",
        "sign_num": 6,
        "degree": 205.298058
      },
      {
        "house": 2,
        "sign": "Vrischika",
        "sign_num": 7,
        "degree": 235.759914
      },
      "... and 10 more items"
    ],
    "bhava_sandhi": [
      {
        "house": 1,
        "sign": "Vrischika",
        "sign_num": 7,
        "degree": 220.528986
      },
      {
        "house": 2,
        "sign": "Dhanu",
        "sign_num": 8,
        "degree": 250.990842
      },
      "... and 10 more items"
    ],
    "graha_drishti": {
      "Sun": {
        "3": 25,
        "4": 75,
        "5": 50,
        "7": 100,
        "8": 75,
        "9": 50,
        "10": 25
      },
      "Moon": {
        "3": 25,
        "4": 75,
        "5": 50,
        "7": 100,
        "8": 75,
        "9": 50,
        "10": 25
      },
      "Mars": {
        "2": 25,
        "3": 100,
        "4": 50,
        "6": 100,
        "7": 100,
        "8": 50,
        "9": 25
      },
      "Mercury": {
        "4": 25,
        "5": 75,
        "6": 50,
        "8": 100,
        "9": 75,
        "10": 50,
        "11": 25
      },
      "Jupiter": {
        "1": 25,
        "6": 25,
        "7": 75,
        "8": 100,
        "10": 100,
        "11": 75,
        "12": 100
      },
      "Venus": {
        "3": 25,
        "4": 75,
        "5": 50,
        "7": 100,
        "8": 75,
        "9": 50,
        "10": 25
      },
      "Saturn": {
        "4": 100,
        "5": 75,
        "6": 50,
        "8": 100,
        "9": 75,
        "10": 50,
        "11": 100
      },
      "Rahu": {
        "1": 100,
        "2": 75,
        "3": 50,
        "4": 25,
        "9": 25,
        "10": 75,
        "11": 50
      },
      "Ketu": {
        "3": 25,
        "4": 75,
        "5": 50,
        "7": 100,
        "8": 75,
        "9": 50,
        "10": 25
      }
    },
    "rashi_drishti": [
      {
        "from_sign": "Mesha",
        "from_sign_num": 0,
        "to_sign": "Simha",
        "to_sign_num": 4
      },
      {
        "from_sign": "Mesha",
        "from_sign_num": 0,
        "to_sign": "Vrischika",
        "to_sign_num": 7
      },
      "... and 35 more items"
    ],
    "arudha_padas": {
      "A1": {
        "sign_index": 3,
        "sign_name": "Karka"
      },
      "A2": {
        "sign_index": 3,
        "sign_name": "Karka"
      },
      "A3": {
        "sign_index": 10,
        "sign_name": "Kumbha"
      },
      "A4": {
        "sign_index": 5,
        "sign_name": "Kanya"
      },
      "A5": {
        "sign_index": 1,
        "sign_name": "Vrishabha"
      },
      "A6": {
        "sign_index": 7,
        "sign_name": "Vrischika"
      },
      "A7": {
        "sign_index": 10,
        "sign_name": "Kumbha"
      },
      "A8": {
        "sign_index": 11,
        "sign_name": "Meena"
      },
      "A9": {
        "sign_index": 0,
        "sign_name": "Mesha"
      },
      "A10": {
        "sign_index": 6,
        "sign_name": "Tula"
      },
      "A11": {
        "sign_index": 8,
        "sign_name": "Dhanu"
      },
      "A12": {
        "sign_index": 9,
        "sign_name": "Makara"
      }
    },
    "upapada_lagna": {
      "sign_index": 9,
      "sign_name": "Makara",
      "upapada_lord": "Saturn",
      "second_from_upapada_sign_index": 10,
      "second_from_upapada_sign_name": "Kumbha",
      "planets_in_second_from_upapada": [],
      "has_benefic_in_second_from_upapada": false,
      "has_malefic_in_second_from_upapada": false
    }
  }
}

Response fields

Field	Type	Description
success	boolean	True if the request succeeded
message	string	Human-readable status message
data	object
data.planets	array[object]	Computed planetary positions
data.planets[].planet	string	Planet name
data.planets[].sign	string	Zodiac sign name where the planet is placed
data.planets[].sign_num	integer	Zero-based zodiac sign index
data.planets[].degree	number	Sidereal longitude in degrees
data.planets[].nakshatra	string	Nakshatra name for planetary placement
data.planets[].nakshatra_pada	integer	Nakshatra pada index
data.planets[].is_retrograde	boolean	Whether the planet is retrograde
data.planets[].is_combust	boolean	True if the planet is within its combustion orb of the Sun
data.planets[].is_deep_combust	boolean	True if within 3° of the Sun (deep combustion / Gadha Moudhya)
data.planets[].house	integer	Whole-sign (Rasi) house number where the planet is placed
data.planets[].rasi_house	integer \| null	Same as `house` when present (explicit Rasi / whole-sign house)
data.planets[].bhava_chalit_house	integer \| null	Bhava Chalit spatial house (1–12) when computed from Bhava Sandhi
data.planets[].house_system_note	string \| null	Guidance on Rashi vs Bhava Chalit house placement when the two systems disagree for this planet.
data.houses	array[object]	Computed house cusp placements
data.houses[].house	integer	House number in the natal chart
data.houses[].sign	string	Sign occupying the house cusp
data.houses[].sign_num	integer	Zero-based zodiac sign index for house cusp
data.houses[].degree	number	House cusp degree within sign
data.ascendant	number	Ascendant longitude in degrees
data.ascendant_sign	string	Ascendant sign name
data.ayanamsa_value	number	Numerical ayanamsa value used in calculations
data.ayanamsa_used	string	Ayanamsa mode used for the chart
data.birth_time_provided	boolean	Whether a precise birth time was provided. False when birth time was not supplied or treated as unknown — calculations using this field will have lagna-dependent accuracy limits.
data.interpretation	array[object] \| null	Interpretation layer for planetary placements when requested
data.ascendant_sign_interpretation	object \| null	Interpretation details for ascendant sign when interpretation is requested
data.moon_sign	string \| null	Moon's rashi (Sanskrit sign name), same as the Moon entry in planets
data.moon_nakshatra	string \| null	Moon's nakshatra name, same as the Moon entry in planets
data.moon_sign_interpretation	object \| null	Interpretation details for Moon sign when interpretation is requested
data.moon_nakshatra_interpretation	object \| null	Interpretation details for Moon nakshatra when interpretation is requested
data.avakahada	object \| null	Standard Avakahada Chakra details derived from Moon nakshatra and sign
data.bhava_madhya	array[BhavaMadhyaEntry] \| null	House midpoint (Bhava Madhya) positions — ecliptic longitude with sign and house label.
data.bhava_sandhi	array[BhavaMadhyaEntry] \| null	House junction (Bhava Sandhi) positions — ecliptic longitude with sign and house label.
data.graha_drishti	object \| null	Graha Drishti matrix (#143): each graha → map of aspected whole-sign house (1–12) to strength percent (25–100).
data.rashi_drishti	array[RashiDrishtiEntry] \| null	Jaimini Rashi Drishti aspect pairs — each entry is one active sign-to-sign aspect.
data.arudha_padas	object \| null	Arudha A1–A12 (#141): each pada → sign_index and sign_name.
data.upapada_lagna	UpapadaLagna \| null	Upapada Lagna (#142): Arudha of 12th house plus 2nd-from-Upapada analysis.

Errors

Code	Description	Reference
authentication_failed	Missing or invalid API key.	authentication_failed
ephemeris_unavailable	Upstream ephemeris service error.	ephemeris_unavailable
insufficient_tier	API key tier does not include this endpoint.	insufficient_tier
internal_error	Unexpected server error.	internal_error
ip_rate_limit_exceeded	Too many requests in a short window.	ip_rate_limit_exceeded
payload_too_large	Request body exceeds the size limit.	payload_too_large
resource_not_found	Referenced resource was not found.	resource_not_found
validation_error	Request body failed schema validation.	validation_error

Endpoint​

Request parameters​

Example request​

Example response​

Response fields​

Errors​

Related endpoints​