Reports

Generate Muhurta Report (PDF or HTML)

Changed on

Render a standard A4 report of the most auspicious dates for a chosen activity over a search window. Same window-scan engine as /vedic/muhurat/*: it scores each day by sunrise Panchang (Tithi/Vara/Nakshatra/Yoga/Karana) per Muhurta Chintamani + B.V.Raman, and lists ranked days with per-day Abhijit Muhurat and the scoring factors as the rationale. activity is one of the 12 from /muhurta/types. PDF default; ?format=html returns HTML.

post/reports/muhurta

Request

  • Base URL: https://api.astroway.info/v1
  • URL: https://api.astroway.info/v1/reports/muhurta
  • Auth: API key in header X-Api-Key

Query parameters

retain_daysinteger

How many days the PDF stays at its url. 1 by default; up to 90 for a link you hand to a client. Delete it sooner with DELETE /v1/reports/files/{filename}.

format'pdf' | 'html'

html returns the rendered report as text/html instead of storing a PDF; nothing is kept.

fieldsstring

Comma-separated dotted paths, relative to data, to keep in the response. A path is applied to every element of an array, so planets.name means the name of each planet. Paths that match nothing come back in _fields_unmatched; a list where nothing matches at all is a 400, because an empty object would be a confident wrong answer.

precisioninteger

Round every non-integer number in the response to this many decimal places. Integers are left alone, because an id is not a measurement. Ecliptic longitudes ship with fourteen decimals by default; 2 is about a tenth of an arcminute.

Request body

activity'marriage' | 'vehicle-purchase' | 'business-start' | 'travel' | 'naming-ceremony' | 'surgery' | 'education-start' | 'investment' | 'property-purchase' | 'journey-long' | 'name-change' | 'general-auspicious' required
search_window_startstring required
search_window_endstring
latitudenumber required
longitudenumber required
timezoneOffsetnumber nullable

Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC.

ayanamsaIdnumber nullable
ayanamsa'fagan-bradley' | 'lahiri' | 'de-luce' | 'raman' | 'krishnamurti' | 'kp' | 'yukteshwar' | 'jn-bhasin' | 'true-citra' | 'djwhal-khul'

Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.

topNinteger
language'uk' | 'en' | 'de' | 'ru' | 'pl' | 'es' | 'pt' | 'hi' | 'fr' | 'ko' | 'it' | 'ja' | 'id' | 'tr' | 'nl' | 'ro' | 'cs' | 'vi' | 'ar' | 'el' | 'hu'

Response

Successful calculation

okboolean

Example response

{
  "ok": true
}

Changes

  • e9234ffdb4f0Revision changes
    • info

      added the new optional query request parameter format

    • info

      added the new optional query request parameter retain_days

  • b64222844186Revision changes
    • info

      added the new optional query request parameter fields

    • info

      added the new optional query request parameter precision