Astrology

Muhurta — Auspicious Timing

Finds and ranks auspicious time windows for an activity between two dates (up to a year) at a location. The range is cut at every change of tithi, nakshatra, yoga, karana, lagna, sunrise and sunset and at the edges of Rahu Kaal, Yamaganda, Gulika, Durmuhurta, Varjyam and Bhadra, so windows start and end at exact moments. A moment is ruled out when the season bars the activity (Chaturmas, Adhik Maas, Pitru Paksha, Kharmas, Holashtak, Guru or Shukra asta, Panchaka, per activity), when its nakshatra, tithi or weekday is not one the activity allows, or when it falls in an inauspicious period. Survivors are scored 0-100 and returned with ISO 8601 start_at and end_at, the civil date and the panchanga day, the reasons and cautions (the earlier fields, including HH:MM start and end on the panchanga day's date, are still returned). Optional participants (up to two) add Tarabala and Chandrabala. Activities: marriage, griha_pravesh, business, travel, naming_ceremony, vehicle_purchase, property_purchase, mundan, annaprashan, upanayana, vidyarambha.

post/v1/astro/muhurta

Request

  • Base URL: https://api.asterwise.com
  • URL: https://api.asterwise.com/v1/astro/muhurta
  • Auth: HTTP bearer

Request body

event_type'marriage' | 'griha_pravesh' | 'business' | 'travel' | 'naming_ceremony' | 'vehicle_purchase' | 'property_purchase' | 'mundan' | 'annaprashan' | 'upanayana' | 'vidyarambha' required

Activity. One of: marriage; griha_pravesh (housewarming); business (starting a business or shop); travel; naming_ceremony; vehicle_purchase; property_purchase; mundan (first haircut); annaprashan (first solid food); upanayana (sacred thread); vidyarambha (beginning education).

from_datestring required

Start date in YYYY-MM-DD format (inclusive)

to_datestring required

End date in YYYY-MM-DD format (inclusive). At most 366 days after from_date.

locationstring nullable

City name, resolved to latitude, longitude and timezone. Not needed when those are given.

latitudenumber nullable

Location latitude

longitudenumber nullable

Location longitude

timezonestring nullable

IANA timezone string e.g. Asia/Kolkata

ayanamsa'lahiri' | 'raman' | 'kp' | 'tropical'

Ayanamsa system: lahiri (default), raman, kp, or tropical for a zero offset, as on every other chart endpoint

top_ninteger

Number of windows to return (1-50)

max_windows_per_dayinteger

At most this many windows per day, so results spread across dates (1-10).

min_duration_minutesinteger

Drop windows shorter than this (1-240 minutes).

Example request

{
  "from_date": "2026-11-21",
  "to_date": "2026-12-15",
  "location": "New Delhi",
  "participants": [
    {
      "label": "Bride",
      "birth_date": "1995-03-14",
      "birth_time": "07:20"
    }
  ]
}

Response

Successful Response

successboolean

True if the request succeeded

messagestring

Human-readable status message

Changes

No recorded changes to this operation across all 2 revisions of this API.