---
title: "Transits day by day"
method: POST
path: "/gochara/range"
tags: ["Transits"]
---

# Transits day by day

`POST /gochara/range`

## Request

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

The same transit reading as /gochara, once per day across a date range of up to 60 days.

Rate limit: 30 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. The API works out the historically correct offset for the place and date from the coordinates, and uses this value only where no time zone is known there.
  - `elevation` number: 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.
  - `from_date` string, required: First day, YYYY-MM-DD.
  - `to_date` string, required: Last day, YYYY-MM-DD. The range covers at most 60 days, counting both ends (400 otherwise).
  - `time_of_day` string: Time used on each day, HH:MM:SS. Defaults to local noon.
  - `event_place` string: Name of the place the transit is read for. Defaults to the birth place.
  - `event_latitude` number: Latitude of the event place. Defaults to the birth latitude.
  - `event_longitude` number: Longitude of the event place. Defaults to the birth longitude.
  - `event_timezone` number: 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_elevation` number: Elevation of the event place, in metres.
  - `include` string[]: Optional sections per day: "ashtakavarga" and "gochara_phala". Both are included by default; pass [] for none, or one of them.

## Response `200`

Success

- object
  - `gochara_range` object: One entry per day. Keys: range, place, ayanamsa_mode, natal_ref, count, days.

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