---
title: "Natal Chart"
method: POST
path: "/api/v1/astrology/natal"
tags: ["astrology-api"]
---

# Natal Chart

`POST /api/v1/astrology/natal`

## Request

- Base URL: `https://api.stellara.natlex.it` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stellara.natlex.it/api/v1/astrology/natal`
- Auth: none declared

Natal chart: 14 points, 12 house cusps, 4 angles, exact aspects.

## Request body

- NatalRequest
  - `birth_datetime` string, required: ISO-8601 datetime WITH timezone, e.g. '1990-05-17T14:30:00Z' or '1990-05-17T17:30:00+03:00'. Naive values are rejected.
  - `latitude` number, required: Birth latitude, degrees
  - `longitude` number, required: Birth longitude, degrees
  - `house_system` string: House system: one of ['alcabitius', 'campanus', 'equal', 'koch', 'morinus', 'placidus', 'porphyry', 'regiomontanus', 'topocentric', 'whole_sign']
  - `include_minor_aspects` boolean: Also report semi-sextile / semi-square / quintile / sesquiquadrate / biquintile / quincunx with tight orbs

## Response `200`

Successful Response

- AstrologyNatalResponse
  - `input` AstroChartInputEcho, required
    - `birth_datetime_utc` string, required
    - `latitude` number, required
    - `longitude` number, required
    - `house_system` string, required
  - `planets` AstroPoint[], required
    - `name` string, required
    - `sign` string, required
    - `degree` number, required
    - `absolute_longitude` number, required
    - `house` integer, nullable
    - `retrograde` boolean, required
    - `speed` number, required
    - `declination` number, required
  - `houses` AstroHouse[], required
    - `house` integer, required
    - `sign` string, required
    - `degree` number, required
    - `absolute_longitude` number, required
  - `angles` AstroAngles, required
    - `ascendant` AstroAngle, required
      - `sign` string, required
      - `degree` number, required
      - `absolute_longitude` number, required
    - `midheaven` AstroAngle, required
      - `sign` string, required
      - `degree` number, required
      - `absolute_longitude` number, required
    - `descendant` AstroAngle, required
      - `sign` string, required
      - `degree` number, required
      - `absolute_longitude` number, required
    - `imum_coeli` AstroAngle, required
      - `sign` string, required
      - `degree` number, required
      - `absolute_longitude` number, required
  - `aspects` AstroNatalAspect[], required
    - `point_a` string, required
    - `point_b` string, required
    - `aspect` string, required
    - `exact_degrees` integer, required
    - `orb` number, required
    - `movement` string, required
  - `meta` AstroMeta, required
    - `engine` string, required
    - `zodiac` string, required
    - `house_system` string, required
    - `orbs` object, required
    - `time_resolution` string, required
    - `points` string[], required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/natlex/apis/stellara-api.md) · [All operations](https://skmtc.dev/natlex/apis/stellara-api/llms.txt) · [OpenAPI document](https://skmtc.dev/natlex/apis/stellara-api/revisions/e576f046b61f?raw)