---
title: "Auspicious dates for an event"
method: POST
path: "/muhurta"
tags: ["Panchang & muhurta"]
---

# Auspicious dates for an event

`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

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.

## 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.
  - `event_type` string, required: The event. GET /muhurta/events lists the valid values.
  - `from_date` string, required: Range start, YYYY-MM-DD.
  - `to_date` string, required: Range end, YYYY-MM-DD. The range covers at most 90 days, counting both ends (400 otherwise).
  - `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.
  - `day_part_resolution_minutes` integer: 5 to 60. Echoed in the response; it does not currently change the scoring.
  - `respect_inauspicious_windows` boolean: Report the Rahu Kalam, Gulika and Yamaganda windows to avoid.

## Response `200`

Success

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

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