POSThttps://yogataraapi.prahlad.app/api/astro/muhurat/

Ceremony muhurats

Request bodyJSON

Paste an API key above to send.

Code snippet

curl -X POST https://yogataraapi.prahlad.app/api/astro/muhurat/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["find_muhurats_in_range"],"date_time":"2025-03-27T13:50:05.104Z","latitude":26.9124,"longitude":75.7873,"timezone":5.5,"start_date":"2025-02-27T13:50:05.104Z","end_date":"2025-03-27T13:50:05.104Z","birth_date":"2025-03-27T13:50:05.104Z","interval_hours":2}'

Finds the times within a date range at which one of five Hindu rites of passage may be performed. Each rite has its own list of permitted nakshatras plus further conditions on tithi, weekday or the Sun's sign, and every sampling instant in the range is tested against all five. The five are mundan (a child's first tonsure), vidyarambha (beginning formal education), upanayana (the sacred thread), graha_pravesha (entering a new house) and deva_pratishtha (installing a deity). Mundan additionally checks the child's age against birth_date and only permits years 1, 3, 5, 7, 10 and 11. Pass start_date, end_date, birth_date, interval_hours and the place. The scan steps through the range at interval_hours and reports each qualifying step as its own two-hour window, so a qualifying day produces several overlapping rows that you will usually want to merge; a smaller interval gives finer boundaries and many more rows. Keep the range to a few weeks — the price is one credit either way, but every step recomputes a full panchanga. The single key is find_muhurats_in_range.

Request fields

Field	Type	Required	Notes
birth_date	string (date-time)	required
date_time	string (date-time)	required	The moment to calculate for, ISO 8601. ALWAYS include an offset or a trailing Z - a value with no zone is read as Asia/Kolkata (UTC+05:30), not UTC, and can return the previous day's result with a 200. '2026-09-01T06:00:00Z' and '2026-09-01 06:00:00' are different instants and give different answers.
end_date	string (date-time)	required
interval_hours	integer	required
keys	array	required	Which calculations to return, as a list of names. See the key table for this endpoint; an unrecognised name rejects the whole request. One call costs one credit however many keys you ask for, so request everything you need at once rather than making several calls.
latitude	number (double)	required	Latitude of the place, in decimal degrees. Positive is north, negative is south. Example: 26.9124 for Jaipur, 40.7128 for New York. Minutes and seconds are not accepted - convert first. min -90 · max 90
longitude	number (double)	required	Longitude of the place, in decimal degrees. Positive is east, negative is west. Example: 75.7873 for Jaipur, -74.0060 for New York. Note the sign: a missing minus puts New York in China. min -180 · max 180
start_date	string (date-time)	required
timezone	number (double)	required	UTC offset of the place, in hours, as a decimal. Example: 5.5 for India (UTC+05:30). Identical in meaning to timezone_as_float, which other endpoints call the same thing by a different name. min -12 · max 14

Available keys (1)

Ask for exactly the calculations you want by listing them in keys. An unknown key rejects the whole request, and you are charged 1 credit however many you ask for — so batch them.

	Key	Extra fields needed	Description
	find_muhurats_in_range	start_date, end_date, birth_date, interval_hours	Scans start_date to end_date in interval_hours steps and reports every step at which one of the five ceremonies is permitted. Returns a list of {muhurat, start_time, end_time, nakshatra, tithi}, muhurat being one of mundan, vidyarambha, upanayana, graha_pravesha or deva_pratishtha. end_time is always start_time plus two hours, and consecutive qualifying steps are emitted as separate overlapping entries rather than merged, so a qualifying day yields several rows.

Full reference for this endpoint