POST/v1/astro/natal

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.

Request parameters

locationoptional

string | null

City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.

nameoptional

string

Person name associated with the birth record

daterequired

string

Birth date in YYYY-MM-DD format

timeoptional

string | null

Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.

latitudeoptional

number | null

Latitude. Required if location not provided.

longitudeoptional

number | null

Longitude. Required if location not provided.

timezoneoptional

string | null

IANA timezone. Required if location not provided.

ayanamsaoptional

string

Sidereal ayanamsa mode used in calculations

include_interpretationoptional

boolean

Whether to include planet-in-house interpretation layer

Response fields

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

authentication_failed

Missing or invalid API key.

ephemeris_unavailable

Upstream ephemeris service error.

insufficient_tier

API key tier does not include this endpoint.

internal_error

Unexpected server error.

ip_rate_limit_exceeded

Too many requests in a short window.

payload_too_large

Request body exceeds the size limit.

resource_not_found

Referenced resource was not found.

validation_error

Request body failed schema validation.

Related endpoints

• Ayanamsha Values
• Graha Nature
• Generate Kundali chart SVG
• Nakshatra Profile

Request

POST·application/json

curl

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"}'

Python

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)

TypeScript

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);

Response

200 OK·application/jsonsigned

{
  "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
    }
  }
}