---
title: "Upcoming transit events"
method: POST
path: "/gochar/events"
tags: ["Transits"]
---

# Upcoming transit events

`POST /gochar/events`

## Request

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

Sign changes and other transit events for the chosen planets over a date range of up to 90 days, with no birth chart.

Responses can be cached for six hours.

Rate limit: 60 requests a minute per IP.

## Request body

- object
  - `from_date` string, required: Range start, YYYY-MM-DD.
  - `to_date` string, required: Range end, YYYY-MM-DD. At most 90 days after from_date.
  - `latitude` number, required: Decimal degrees, -90 to 90. Used for the display timezone.
  - `longitude` number, required: Decimal degrees, -180 to 180, east positive.
  - `timezone` number, required: UTC offset, in hours, for expressing event dates. The API works out the offset from the coordinates where it can; this value is the fallback.
  - `place` string: Place name, echoed in the response. Coordinates decide the calculation.
  - `planets` string[]: Planet names. Defaults to all nine: Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu.
  - `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
  - `gochar_events` object: Events in the range. Keys: range, timezone, ayanamsa_mode, planets, events.

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