Transits

Transits against a birth chart

Where the planets are at a target date and time, read against a birth chart: each planet's sign, house from the lagna and Moon, nakshatra, Ashtakavarga support and the panchanga and muhurta windows of the day.

Rate limit: 60 requests a minute per IP.

post/gochara

Request

  • Base URL: https://jagannatha-hora-359167915530.europe-west1.run.app
  • URL: https://jagannatha-hora-359167915530.europe-west1.run.app/gochara
  • Auth: none declared

Request body

datestring required

Birth date, YYYY-MM-DD. Years 1800 to 2100.

timestring required

Birth time, HH:MM:SS on a 24-hour clock.

placestring

Place name, echoed in the response. Coordinates decide the calculation.

latitudenumber required

Decimal degrees, north positive. Places beyond about 66.5° north or south (inside the polar circles) are rejected with 422.

longitudenumber required

Decimal degrees, -180 to 180, east positive.

timezonenumber required

UTC offset in hours at birth, -12 to 14 (5.5 for India). By default the API works out the historically correct offset, including daylight saving, from the coordinates and date; see timezone_mode.

elevationnumber

Metres above sea level.

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.

node_type'mean' | 'true'

Rahu and Ketu as the mean or the true lunar node.

timezone_mode'auto' | 'file'

auto works out the historical offset from the coordinates and date, falling back to timezone where no zone is known. file uses timezone exactly as sent. The response reports the offset used.

target_datestring required

The date to read transits for, YYYY-MM-DD.

target_timestring

Time on the target date, HH:MM:SS. Defaults to local noon.

event_placestring

Name of the place the transit is read for. Defaults to the birth place.

event_latitudenumber

Latitude of the event place. Defaults to the birth latitude.

event_longitudenumber

Longitude of the event place. Defaults to the birth longitude.

event_timezonenumber

UTC offset of the event place, in hours. The API works out the offset from the event coordinates where it can; this value, or the birth offset, is the fallback.

event_elevationnumber

Elevation of the event place, in metres.

includestring[]

Optional sections: "ashtakavarga", "gochara_phala", "transit_charts". All three are included by default; pass [] for none, or a subset.

Response

Success

birth_detailsobject

The birth inputs as used. Keys: date, time, place, latitude, longitude, timezone.

gocharaobject

The transit snapshot. Keys: target, natal_ref, panchanga, muhurta, planets, person_strength, transit_charts.

Changes

No recorded changes to this operation across all 1 revision of this API.