Pick the best auspicious time

Use /v1/muhurta/best-time to scan a window for the highest-scoring moment.

Given a date range and event type, LifeAstroAPI scans every half-hora and returns the top candidates:

GET /v1/muhurta/best-time?
  purpose=vivah&
  start_date=2026-11-01&end_date=2026-11-30&
  lat=28.61&lon=77.21&tz=Asia/Kolkata

The window can be up to 31 days. Pass birth_date to include the person's Tara Bala and Chandra Bala.

Returns the best windows, ranked, each with its score and the factors behind it (30 credits for the scan). Times are in UTC (ISO 8601); convert them to the user's timezone for display:

{
  "purpose": "vivah",
  "start_date": "2026-11-01",
  "end_date": "2026-11-30",
  "windows": [
    {
      "start_iso": "2026-11-11T01:59:59Z",
      "end_iso": "2026-11-11T02:59:59Z",
      "score": 100,
      "grade": "excellent",
      "is_acceptable": true,
      "factors": [
        {
          "name": "Tithi",
          "value": "Dwitiya",
          "weight": 12,
          "score": 12,
          "ok": true
        },
        {
          "name": "Vara",
          "value": "Wednesday",
          "weight": 10,
          "score": 10,
          "ok": true
        },
        {
          "name": "Nakshatra",
          "value": "Anuradha",
          "weight": 15,
          "score": 15,
          "ok": true
        }
      ]
    }
  ]
}