---
title: "Sade Sati and Saturn timeline"
method: POST
path: "/saturn-timeline"
tags: ["Birth charts & matching"]
---

# Sade Sati and Saturn timeline

`POST /saturn-timeline`

## Request

- Base URL: `https://jagannatha-hora-359167915530.europe-west1.run.app`
- URL: `https://jagannatha-hora-359167915530.europe-west1.run.app/saturn-timeline`
- Auth: none declared

Sade Sati and dhaiyya periods for a birth chart, measured from the Moon sign. `sadeSati` describes the cycle in progress; if none is running, the next one (or the most recent, if none is ahead). `nextCycle` is the next cycle to begin.

Which cycle is current, and the months remaining, are measured from today's date, so the response changes over time for the same inputs.

Rate limit: 60 requests a minute per IP.

## Request body

- object
  - `date` string, required: Birth date, YYYY-MM-DD. Years 1800 to 2100.
  - `time` string, required: Birth time, HH:MM:SS on a 24-hour clock.
  - `place` string: Place name, echoed in the response. Coordinates decide the calculation.
  - `latitude` number, required: Decimal degrees, north positive. Places beyond about 66.5° north or south (inside the polar circles) are rejected with 422.
  - `longitude` number, required: Decimal degrees, -180 to 180, east positive.
  - `timezone` number, required: UTC offset in hours, -12 to 14 (5.5 for India).
  - `ayanamsa_mode` 'LAHIRI' | 'RAMAN': LAHIRI or RAMAN only on this endpoint.
  - `detail` 'summary' | 'full': summary returns the phases; full adds the month-by-month detail.

## Response `200`

Success

- object
  - `saturn_timeline` object: The Moon sign and the Saturn periods measured from it. Keys: moonSign, moonDegree, sadeSati, dhaiyya, nextCycle.

## Other responses

- `400`: The input cannot be used for this calculation. The detail says why.
- `422`: A field is missing or out of range. The detail says which.
- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/jagannathahora/apis/vedic-astrology-calculation-api.md) · [All operations](https://skmtc.dev/jagannathahora/apis/vedic-astrology-calculation-api/llms.txt) · [OpenAPI document](https://skmtc.dev/jagannathahora/apis/vedic-astrology-calculation-api/revisions/bb90e41e2ba1?raw)