---
title: "Synastry"
method: POST
path: "/api/v1/astrology/synastry"
tags: ["astrology-api"]
---

# Synastry

`POST /api/v1/astrology/synastry`

## 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/synastry`
- Auth: none declared

Inter-chart aspects between two people + house overlays.

## Request body

- SynastryRequest
  - `person_a` ChartInputRequest, required: One person's birth data.
    - `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']
  - `person_b` ChartInputRequest, required: One person's birth data.
    - `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

## Response `200`

Successful Response

- AstrologySynastryResponse
  - `person_a` AstrologyNatalResponse, required
    - `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
  - `person_b` AstrologyNatalResponse, required
    - `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
  - `inter_aspects` AstroSynastryAspect[], required
    - `point_a` string, required
    - `point_b` string, required
    - `aspect` string, required
    - `exact_degrees` integer, required
    - `orb` number, required
  - `house_overlays` AstroHouseOverlays, required
    - `a_in_b_houses` AstroHouseOverlayItem[], required
      - `planet` string, required
      - `house` integer, required
    - `b_in_a_houses` AstroHouseOverlayItem[], required
      - `planet` string, required
      - `house` integer, 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)