---
title: "When a planet changes sign"
method: POST
path: "/planet-ingress"
tags: ["Transits"]
---

# When a planet changes sign

`POST /planet-ingress`

## Request

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

The dates each chosen planet enters a new sign over a date range of up to about five years.

Rate limit: 60 requests a minute per IP.

## Request body

- object
  - `planets` string[]: Planet names (Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu). Defaults to Saturn, Jupiter, Rahu and Ketu. An unknown name returns 400.
  - `from_date` string, required: Range start, YYYY-MM-DD.
  - `to_date` string, required: Range end, YYYY-MM-DD. Must be after from_date and at most about five years later (400 otherwise).
  - `timezone` number: UTC offset, in hours, that crossing dates are expressed in. Defaults to UTC.
  - `ayanamsa_mode` 'LAHIRI' | 'TRUE_CITRA' | 'TRUE_LAHIRI' | 'KP' | 'FAGAN' | 'RAMAN' | 'USHASHASHI' | 'YUKTESHWAR' | 'SURYASIDDHANTA' | 'SURYASIDDHANTA_MSUN' | 'ARYABHATA' | 'ARYABHATA_MSUN' | 'SS_CITRA' | 'TRUE_REVATI' | 'SS_REVATI' | 'TRUE_PUSHYA' | 'TRUE_MULA' | 'KP-SENTHIL' | 'SENTHIL': Ayanamsa (sidereal zodiac) to use. Case-insensitive. A value the API does not recognise as one of the listed modes is refused with HTTP 422 and a message listing them; it is never replaced by LAHIRI.

## Response `200`

Success

- object
  - `planet_ingress` object: Sign changes in the range. Keys: range, timezone, ayanamsa_mode, planets, ingresses.

## 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)