--- title: "Muhurta — Auspicious Timing" method: POST path: "/v1/astro/muhurta" tags: ["Astrology"] --- # Muhurta — Auspicious Timing `POST /v1/astro/muhurta` ## Request - Base URL: `https://api.asterwise.com` - URL: `https://api.asterwise.com/v1/astro/muhurta` - Auth: HTTP bearer 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. ## Request body - MuhurtaRequest - `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_date` string, required: Start date in YYYY-MM-DD format (inclusive) - `to_date` string, required: End date in YYYY-MM-DD format (inclusive). At most 366 days after from_date. - `location` string, nullable: City name, resolved to latitude, longitude and timezone. Not needed when those are given. - `latitude` number, nullable: Location latitude - `longitude` number, nullable: Location longitude - `timezone` string, 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_n` integer: Number of windows to return (1-50) - `max_windows_per_day` integer: At most this many windows per day, so results spread across dates (1-10). - `min_duration_minutes` integer: Drop windows shorter than this (1-240 minutes). - `participants` MuhurtaParticipant[], nullable: Up to two people (e.g. bride and groom). Adds Tarabala and Chandrabala: a Naidhana tara or the Moon in the 8th house from a participant's Moon rules a moment out. - `label` string, nullable: Name used in the output, e.g. 'Bride'. - `nakshatra` union: Janma nakshatra: a name (e.g. 'Rohini') or 1-27. - string - integer - `moon_rashi` union: Janma rashi (Moon sign): a name ('Vrishabha' or 'Taurus') or 1-12. - string - integer - `birth_date` string, nullable: YYYY-MM-DD - `birth_time` string, nullable: HH:MM (24-hour, local time at the birth place) - `birth_latitude` number, nullable: Birthplace latitude in decimal degrees, north positive. - `birth_longitude` number, nullable: Birthplace longitude in decimal degrees, east positive. - `birth_timezone` string, nullable: IANA timezone of the birth place ## Response `200` Successful Response - ApiResponseMuhurtaResponse - `success` boolean: True if the request succeeded - `message` string: Human-readable status message - `data` MuhurtaResponse, required - `event_type` string, required - `activity` string, required - `from_date` string, required - `to_date` string, required - `timezone` string, required - `ayanamsa` string, required - `criteria` MuhurtaCriteria, required - `nakshatras` string[], required - `recommended_nakshatras` string[], required - `tithis` string[], required - `weekdays` string[], required - `preferred_lagnas` string[], required - `avoided_seasons` string[], required - `avoided_periods` string[], required - `daytime_only` boolean, required - `total_windows_found` integer, required: Valid windows in the range before top_n is applied. - `total_windows_evaluated` integer, required: Pieces of time examined (cut at every change). - `excluded_minutes` object, required: Minutes ruled out, by first reason: chaturmas, adhik_maas, pitru_paksha, kharmas, holashtak, guru_asta, shukra_asta, panchaka, night, weekday, tithi, nakshatra, yoga, rahu_kaal, yamaganda, gulika, durmuhurta, varjyam, bhadra, tarabala, chandrabala. - `top_windows` MuhurtaWindow[], required - `date` string, required: Panchanga day (the date of the sunrise that opens it). A window after midnight carries the previous calendar date here. Kept from the earlier Choghadiya-slot response; prefer civil_date and start_at. - `start` string, required: Start, HH:MM local time. Kept from the earlier Choghadiya-slot response; prefer start_at. - `end` string, required: End, HH:MM local time. Kept from the earlier Choghadiya-slot response; prefer end_at. - `score` integer, required: 0-100. - `choghadiya` string, required: Choghadiya at the window's start. - `choghadiya_type` string, required - `yoga` string, required: Panchanga yoga name. - `vara` string, required: Weekday name (Sanskrit). - `vara_number` integer, required: 1 = Sunday ... 7 = Saturday. - `tithi` string, required: Tithi name; see paksha and tithi_number. - `tithi_number` integer, required: 1-30 (16-30 Krishna). - `reason` string, required: Reasons joined into one line. Kept from the earlier Choghadiya-slot response; prefer reasons. - `is_rahu_kaal` boolean, required: Always false: Rahu Kaal is excluded from every window. - `is_abhijit` boolean, required - `is_amrita_siddhi` boolean, required - `is_sarvartha_siddhi` boolean, required - `start_at` string, required: Window start, ISO 8601 local time with offset. - `end_at` string, required: Window end, ISO 8601 local time with offset. - `civil_date` string, required: Calendar date on which the window starts. - `panchanga_day` string, required: Same as date: the sunrise date of the panchanga day. - `duration_minutes` number, required - `grade` string, required: Excellent (85+), Good (70+) or Acceptable. - `paksha` string, required - `nakshatra` MuhurtaNamed, required - `number` integer, required - `name` string, required - `yoga_number` integer, required - `karana` string, required - `vara_lord` string, required - `lagna` MuhurtaLagna - `index` integer, required: 0 = Mesha ... 11 = Meena (sidereal). - `name` string, required - `masa` string, required: Amanta lunar month. - `is_guru_pushya` boolean, required - `is_ravi_pushya` boolean, required - `reasons` string[], required: What makes the window good. - `cautions` string[], required: Weaker points of an otherwise valid window. - `tarabala` MuhurtaTara[], nullable - `participant` string, required - `tara` string, required - `count_from_birth` integer, required - `is_favorable` boolean, required - `chandrabala` MuhurtaChandra[], nullable - `participant` string, required - `moon_house` integer, required - `is_favorable` boolean, required - `notes` string[], required ## Other responses - `401`: Authentication failed - `403`: Authorization failed - `404`: Resource not found - `413`: Payload too large - `422`: Validation error - `429`: Rate limit exceeded - `500`: Internal error - `502`: Upstream provider error - `503`: Service unavailable --- [API](https://skmtc.dev/asterwise/apis/asterwise-api.md) · [All operations](https://skmtc.dev/asterwise/apis/asterwise-api/llms.txt) · [OpenAPI document](https://skmtc.dev/asterwise/apis/asterwise-api/revisions/3c4bbb1194e2?raw)