vibz.art/docs
API ReferenceLilavati

Compute Vivah Muhurat

Compute auspicious Hindu wedding (Vivah) dates with sub-day windows. Enforces 13 classical criteria from Muhurta Chintamani, Dharma Sindhu, and Brihat Samhita — including Kharmas, Chaturmasa, Shukra/Guru Asta, and Amritadi Marana Yoga rejections. Targets parity-or-better with Drik Panchang.

GET /lilavati/v1/vivah-muhurat

Compute auspicious Hindu wedding (Vivah) dates with sub-day windows.

Enforces 13 classical criteria from Muhurta Chintamani, Dharma Sindhu, and Brihat Samhita — including Kharmas, Chaturmasa, Shukra/Guru Asta, and Amritadi Marana Yoga rejections. Targets parity-or-better with Drik Panchang.

Parameters

ParameterTypeRequiredDescription
start_datestringNoStart of search range (YYYY-MM-DD). Defaults to today.
end_datestringNoEnd of search range (YYYY-MM-DD). Defaults to 12 months from start.
max_resultsintegerNoMaximum number of auspicious dates to return. Default: 20
calendar_systemstringNoLunar calendar system (purnimant or amant). Default: purnimant
include_windowsbooleanNoIf true, compute window-level sub-muhurats (Drik-style). Slightly slower but much more useful output. Default: true
latnumberYesLatitude
lngnumberYesLongitude
tzstringNoIANA timezone (e.g. 'Asia/Kolkata') Default: Asia/Kolkata
altitudenumberNoAltitude in meters Default: 0

Response

FieldTypeDescription
start_datestringStart Date
end_datestringEnd Date
locationstringLocation description (lat, lng)
total_dates_evaluatedintegerTotal Dates Evaluated
auspicious_countintegerAuspicious Count
datesVivahDateDetail[]Dates

On this page