---
title: "Get Current Transits"
method: GET
path: "/api/natal/transits"
tags: ["natal"]
---

# Get Current Transits

`GET /api/natal/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/natal/transits`
- Auth: HTTP bearer

Get current planetary transits and their impact on the user's chart.

Cache behaviour (migration 037):
- First call for (user, today): ephemeris + Gemini, charge coins,
  store in `transit_readings`.
- Subsequent calls same day: serve the cached row for free.
- `?force=true`: bypass cache, regenerate, charge coins.
- Edited birth data → profile_hash mismatch → cache miss → regen.

## Query parameters

- `force` boolean

## Response `200`

Successful Response

- TransitsResponse
  - `date` string, required
  - `zodiac_sign` string, required
  - `transits` unknown, 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)