GET /v1/natal-chart — Full natal chart with positions, houses, aspects, parallels, dignities, and house placements.

Natal Chart

Compute a complete natal chart in a single request. Returns planetary positions with sign and degree, house cusps, aspects, parallels, essential dignities, house placements, retrograde flags, and out-of-bounds detection.

Text

GET  /v1/natal-chart
POST /v1/natal-chart

Credit cost: 2

Parameters

Parameter	Type	Required	Default	Description
`datetime`	string	One of `datetime` or `jd`	—	ISO 8601 UTC datetime
`jd`	number	One of `datetime` or `jd`	—	Julian Day in UT1
`lat`	number	Yes	—	Observer latitude (-90 to 90)
`lon`	number	Yes	—	Observer longitude (-180 to 180)
`bodies`	string	No	`"planets"`	Comma-separated body names, or `"planets"`, `"all"`
`system`	string	No	`"placidus"`	House system
`sidereal`	string	No	—	Ayanamsha for sidereal mode
`aspects`	string	No	Major 7	Comma-separated aspect types
`orb`	number	No	—	Global orb override in degrees
`applying`	boolean	No	`false`	Include applying/separating flag on aspects
`parallels`	boolean	No	`false`	Include declination parallels
`parallel_orb`	number	No	`1.0`	Orb for parallels in degrees
`rulership`	string	No	`"traditional"`	Dignity system: `"traditional"` or `"modern"`
`day_chart`	boolean	No	—	Whether this is a day chart (for triplicity rulers)

Response

JSON

{
  "data": {
    "metadata": {
      "jd": 2448083.2708333,
      "datetime": "1990-06-15T18:30:00Z",
      "lat": 40.7128,
      "lon": -74.006,
      "house_system": "placidus",
      "sidereal": null,
      "bodies": ["sun", "moon", "mercury", "venus", "mars", "jupiter", "saturn", "uranus", "neptune", "pluto", "mean_node", "chiron"],
      "source": "natal"
    },
    "bodies": [
      {
        "name": "sun",
        "longitude": 84.83,
        "latitude": 0.0002,
        "distance": 1.0158,
        "speed": 0.9534,
        "declination": 23.32,
        "sign": "gemini",
        "sign_degree": 24.83,
        "house": 10,
        "retrograde": false,
        "out_of_bounds": false
      }
    ],
    "houses": {
      "cusps": [120.5, 145.2, 172.8, 200.1, 228.4, 258.7, 300.5, 325.2, 352.8, 20.1, 48.4, 78.7],
      "ascendant": 120.5,
      "mc": 20.1,
      "vertex": 230.8
    },
    "aspects": [
      {
        "body_a": "sun",
        "body_b": "moon",
        "aspect": "trine",
        "angle": 120.0,
        "orb": 1.23,
        "applying": true
      }
    ],
    "parallels": [],
    "dignities": [
      {
        "body": "sun",
        "sign": "gemini",
        "dignity": null,
        "debility": null,
        "score": 0,
        "peregrine": true
      }
    ]
  },
  "meta": { "..." }
}

Key response fields

Field	Description
`metadata`	Chart context: datetime, location, house system, source type
`bodies[]`	Position data with sign, degree, house placement, retrograde, and OOB flags
`houses`	12 house cusps plus Ascendant, MC, and Vertex
`aspects[]`	Aspects between bodies with type, exact angle, orb, and optionally applying/separating
`parallels[]`	Declination parallels and contraparallels (when `parallels=true`)
`dignities[]`	Essential dignity/debility for each body with score and peregrine flag

Examples

Basic natal chart

Bash

curl "https://api.morphemeris.com/v1/natal-chart?datetime=1990-06-15T18:30:00Z&lat=40.7128&lon=-74.006" \
  -H "Authorization: Bearer morphemeris_live_YOUR_KEY"

javascript

const res = await fetch(
  "https://api.morphemeris.com/v1/natal-chart?datetime=1990-06-15T18:30:00Z&lat=40.7128&lon=-74.006",
  { headers: { Authorization: "Bearer morphemeris_live_YOUR_KEY" } }
);
const { data } = await res.json();

Python

import requests

res = requests.get(
    "https://api.morphemeris.com/v1/natal-chart",
    params={"datetime": "1990-06-15T18:30:00Z", "lat": 40.7128, "lon": -74.006},
    headers={"Authorization": "Bearer morphemeris_live_YOUR_KEY"},
)
data = res.json()

With parallels and modern rulership

Bash

curl "https://api.morphemeris.com/v1/natal-chart?datetime=1990-06-15T18:30:00Z&lat=40.7128&lon=-74.006&parallels=true&rulership=modern&applying=true" \
  -H "Authorization: Bearer morphemeris_live_YOUR_KEY"

Vedic natal chart

Bash

curl "https://api.morphemeris.com/v1/natal-chart?datetime=1990-06-15T18:30:00Z&lat=40.7128&lon=-74.006&sidereal=lahiri&system=whole_sign" \
  -H "Authorization: Bearer morphemeris_live_YOUR_KEY"

Tips

Use /v1/natal-chart instead of separate /v1/chart + manual aspect calculation — it costs 2 credits but returns everything you need for a complete chart interpretation.
Include chiron and mean_node in the bodies list — most modern chart systems use them.
Set day_chart=true for daytime births to get accurate triplicity ruler dignities.
The default aspects are the 7 major aspects: conjunction, opposition, trine, square, sextile, quincunx, and semisextile.

Natal Chart

On this page