---
title: "Transits"
method: POST
path: "/api/v1/astrology/transits"
tags: ["astrology-api"]
---

# Transits

`POST /api/v1/astrology/transits`

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

Transiting positions at ``target_datetime`` + aspects to the natal
points, with applying / separating and exact orbs.

## Request body

- TransitsRequest
  - `natal` 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']
  - `target_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.
  - `include_minor_aspects` boolean

## Response `200`

Successful Response

- AstrologyTransitsResponse
  - `natal` 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
  - `target_datetime_utc` string, required
  - `transiting_planets` AstroTransitingPoint[], required
    - `name` string, required
    - `sign` string, required
    - `degree` number, required
    - `absolute_longitude` number, required
    - `retrograde` boolean, required
    - `speed` number, required
    - `declination` number, required
    - `natal_house` integer, required
  - `aspects_to_natal` AstroTransitAspect[], required
    - `transiting` string, required
    - `natal` 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)