Panchang & muhurta

Auspicious dates for an event

Scores each day in a range of up to 90 days for an event type, using the classical day factors and the person's own strength on that day, and returns the scored candidates with the windows to avoid.

Rate limit: 30 requests a minute per IP.

post/muhurta

Request

  • Base URL: https://jagannatha-hora-359167915530.europe-west1.run.app
  • URL: https://jagannatha-hora-359167915530.europe-west1.run.app/muhurta
  • 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, -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.

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.

event_typestring required

The event. GET /muhurta/events lists the valid values.

from_datestring required

Range start, YYYY-MM-DD.

to_datestring required

Range end, YYYY-MM-DD. The range covers at most 90 days, counting both ends (400 otherwise).

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.

day_part_resolution_minutesinteger

5 to 60. Echoed in the response; it does not currently change the scoring.

respect_inauspicious_windowsboolean

Report the Rahu Kalam, Gulika and Yamaganda windows to avoid.

Response

Success

muhurtaobject

Scored days for the event. Keys: event_type, event_label, range, rules_applied, weights, day_part_resolution_minutes, candidates.

Changes

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