AstroLogics API

API reference › Panchang & muhurat

Muhurat Scan API (62 Days)

Scan up to 62 days for an activity inside daily hours: the ten best days with their favourable windows

POST/v1/muhurat/scan

3 credits · Secret key (test or live) · scanMuhurat

For each day from from to to (less exclude_dates): Abhijit and the favourable day choghadiyas (amrit, shubh, labh) with Rahu Kaal, Yamaganda and Gulika cut out, clipped to active_window (local time at the place; default 09:00–17:00). score counts the distinct choghadiyas left, plus 1 for Abhijit. Each day also carries its tithi, nakshatra, their classes and the activity's day judgement (day_score, band, rejections) at 12:00 IST. Ranked: days without a rejection first, then score, then day_score; the top ten.

Request body

  • from string (date) required

    e.g. "1990-08-13"

  • to string (date) required

    e.g. "1990-08-13"

  • place Coordinates or object or object required

    Coordinates, a place_id from /v1/places/search, or a free-text query. A vague query returns 422 place_ambiguous with candidates; the API never guesses.

    One of:

    1. Coordinates
      Fields
      • latitude number required

        ≥ -90 · ≤ 90

      • longitude number required

        ≥ -180 · ≤ 180

      No other fields are accepted.

    2. object
      Fields
      • place_id string required

      No other fields are accepted.

    3. object
      Fields
      • query string required

        at least 2 characters · at most 120 characters

      No other fields are accepted.

  • active_window object
    • start string required

      pattern ^([01]\d|2[0-3]):[0-5]\d$

    • end string required

      pattern ^([01]\d|2[0-3]):[0-5]\d$

    No other fields are accepted.

  • exclude_dates array of string (date)

    Days not to scan (holidays, weekends): the API keeps no market calendar.

    at most 62 items

  • activity string required

    business_start and listing are judged as business.

    one of business_start, listing, marriage, griha-pravesh, business, vehicle, travel, education, namkaran, property

No other fields are accepted.

Response

JSON { data, meta, warnings }, where data is:

  • activity string required
  • judged_as string required
  • from string (date) required

    e.g. "1990-08-13"

  • to string (date) required

    e.g. "1990-08-13"

  • active_window object required
    • start string required
    • end string required
  • best object or null required

    One of:

    1. object
      Fields
      • date string (date) required

        e.g. "1990-08-13"

      • weekday string required
      • score integer required

        The distinct favourable choghadiyas (amrit, shubh, labh) in the active window, plus 1 if Abhijit is in it.

      • favourable_windows array of object required
        Fields
        • name string required

          one of abhijit, amrit, shubh, labh

        • start string required

          HH:MM, local time at the place.

        • end string required
        • minutes integer required
      • abhijit_in_window boolean required
      • tithi string required
      • tithi_group string required

        one of nanda, bhadra, jaya, rikta, purna

      • paksha string required

        one of shukla, krishna

      • nakshatra NakshatraId required

        The 27 nakshatras, 1 Ashwini … 27 Revati. Spellings are fixed: mula (not moola), shatabhisha (not satabhisha), purva_ashadha, uttara_bhadrapada.

        one of ashwini, bharani, krittika, rohini, mrigashira, ardra, punarvasu, pushya, ashlesha, magha, purva_phalguni, uttara_phalguni, hasta, chitra, swati, vishakha, anuradha, jyeshtha, mula, purva_ashadha, uttara_ashadha, shravana, dhanishta, shatabhisha, purva_bhadrapada, uttara_bhadrapada, revati

      • nakshatra_group string required
      • yoga string required
      • karana string required
      • day_score integer required

        The day's muhurat score for the activity (/v1/muhurat/search's judgement, read at 12:00 IST).

      • band string required
      • rejected boolean required
      • rejections array of string required
    2. null
  • days array of object required
    • date string (date) required

      e.g. "1990-08-13"

    • weekday string required
    • score integer required

      The distinct favourable choghadiyas (amrit, shubh, labh) in the active window, plus 1 if Abhijit is in it.

    • favourable_windows array of object required
      Fields
      • name string required

        one of abhijit, amrit, shubh, labh

      • start string required

        HH:MM, local time at the place.

      • end string required
      • minutes integer required
    • abhijit_in_window boolean required
    • tithi string required
    • tithi_group string required

      one of nanda, bhadra, jaya, rikta, purna

    • paksha string required

      one of shukla, krishna

    • nakshatra NakshatraId required

      The 27 nakshatras, 1 Ashwini … 27 Revati. Spellings are fixed: mula (not moola), shatabhisha (not satabhisha), purva_ashadha, uttara_bhadrapada.

      one of ashwini, bharani, krittika, rohini, mrigashira, ardra, punarvasu, pushya, ashlesha, magha, purva_phalguni, uttara_phalguni, hasta, chitra, swati, vishakha, anuradha, jyeshtha, mula, purva_ashadha, uttara_ashadha, shravana, dhanishta, shatabhisha, purva_bhadrapada, uttara_bhadrapada, revati

    • nakshatra_group string required
    • yoga string required
    • karana string required
    • day_score integer required

      The day's muhurat score for the activity (/v1/muhurat/search's judgement, read at 12:00 IST).

    • band string required
    • rejected boolean required
    • rejections array of string required
  • scanned_days integer required
  • excluded_days integer required

Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.

Example request

curl -X POST 'https://api.astrologics.in/v1/muhurat/scan' \
  -H 'Authorization: Bearer al_test_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"from":"2026-11-02","to":"2026-11-13","place":{"latitude":19.076,"longitude":72.8777},"active_window":{"start":"09:15","end":"15:30"},"exclude_dates":["2026-11-07","2026-11-08"],"activity":"business_start"}'
Node.js
const res = await fetch("https://api.astrologics.in/v1/muhurat/scan", {
  method: "POST",
  headers: { Authorization: "Bearer al_test_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    "from": "2026-11-02",
    "to": "2026-11-13",
    "place": {
      "latitude": 19.076,
      "longitude": 72.8777
    },
    "active_window": {
      "start": "09:15",
      "end": "15:30"
    },
    "exclude_dates": [
      "2026-11-07",
      "2026-11-08"
    ],
    "activity": "business_start"
  }),
});
console.log(JSON.stringify(await res.json(), null, 2));
Python
import json
import urllib.error
import urllib.request

body = {
    "from": "2026-11-02",
    "to": "2026-11-13",
    "place": {
        "latitude": 19.076,
        "longitude": 72.8777,
    },
    "active_window": {
        "start": "09:15",
        "end": "15:30",
    },
    "exclude_dates": [
        "2026-11-07",
        "2026-11-08",
    ],
    "activity": "business_start",
}

req = urllib.request.Request(
    "https://api.astrologics.in/v1/muhurat/scan",
    method="POST",
    headers={"Authorization": "Bearer al_test_YOUR_KEY", "Content-Type": "application/json"},
    data=json.dumps(body).encode(),
)
try:
    with urllib.request.urlopen(req) as res:
        print(json.dumps(json.load(res), indent=2, ensure_ascii=False))
except urllib.error.HTTPError as err:
    print(err.code, err.read().decode())
PHP
<?php
$ch = curl_init('https://api.astrologics.in/v1/muhurat/scan');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"from":"2026-11-02","to":"2026-11-13","place":{"latitude":19.076,"longitude":72.8777},"active_window":{"start":"09:15","end":"15:30"},"exclude_dates":["2026-11-07","2026-11-08"],"activity":"business_start"}',
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 9,112 characters
{
  "data": {
    "activity": "business_start",
    "judged_as": "business",
    "from": "2026-11-02",
    "to": "2026-11-13",
    "active_window": {
      "start": "09:15",
      "end": "15:30"
    },
    "best": {
      "date": "2026-11-06",
      "weekday": "friday",
      "score": 3,
      "favourable_windows": [
        {
          "name": "amrit",
          "start": "09:32",
          "end": "10:57",
          "minutes": 85
        },
        {
          "name": "abhijit",
          "start": "12:22",
          "end": "12:45",
          "minutes": 23
        },
        {
          "name": "shubh",
          "start": "12:22",
          "end": "13:47",
          "minutes": 85
        }
      ],
      "abhijit_in_window": true,
      "tithi": "trayodashi",
      "tithi_group": "jaya",
      "paksha": "krishna",
      "nakshatra": "hasta",
      "nakshatra_group": "kshipra",
      "yoga": "vishkambha",
      "karana": "gara",
      "day_score": 74,
      "band": "excellent",
      "rejected": false,
      "rejections": []
    },
    "days": [
      {
        "date": "2026-11-06",
        "weekday": "friday",
        "score": 3,
        "favourable_windows": [
          {
            "name": "amrit",
            "start": "09:32",
            "end": "10:57",
            "minutes": 85
          },
          {
            "name": "abhijit",
            "start": "12:22",
            "end": "12:45",
            "minutes": 23
          },
          {
            "name": "shubh",
            "start": "12:22",
            "end": "13:47",
            "minutes": 85
          }
        ],
        "abhijit_in_window": true,
        "tithi": "trayodashi",
        "tithi_group": "jaya",
        "paksha": "krishna",
        "nakshatra": "hasta",
        "nakshatra_group": "kshipra",
        "yoga": "vishkambha",
        "karana": "gara",
        "day_score": 74,
        "band": "excellent",
        "rejected": false,
        "rejections": []
      },
      {
        "date": "2026-11-02",
        "weekday": "monday",
        "score": 3,
        "favourable_windows": [
          {
            "name": "shubh",
            "start": "09:31",
            "end": "10:56",
            "minutes": 85
          },
          {
            "name": "abhijit",
            "start": "12:22",
            "end": "12:45",
            "minutes": 23
          },
          {
            "name": "labh",
            "start": "15:13",
            "end": "15:30",
            "minutes": 17
          }
        ],
        "abhijit_in_window": true,
        "tithi": "ashtami",
        "tithi_group": "jaya",
        "paksha": "krishna",
        "nakshatra": "ashlesha",
        "nakshatra_group": "tikshna",
        "yoga": "shubha",
        "karana": "kaulava",
        "day_score": 52,
        "band": "fair",
        "rejected": false,
        "rejections": []
      },
      {
        "date": "2026-11-12",
        "weekday": "thursday",
        "score": 2,
        "favourable_windows": [
          {
            "name": "abhijit",
            "start": "12:00",
            "end": "12:45",
            "minutes": 45
          },
          {
            "name": "labh",
            "start": "12:23",
            "end": "13:47",
            "minutes": 84
          }
        ],
        "abhijit_in_window": true,
        "tithi": "tritiya",
        "tithi_group": "jaya",
        "paksha": "shukla",
        "nakshatra": "jyeshtha",
        "nakshatra_group": "tikshna",
        "yoga": "sukarma",
        "karana": "gara",
        "day_score": 52,
        "band": "fair",
        "rejected": false,
        "rejections": []
      },
      {
        "date": "2026-11-03",
        "weekday": "tuesday",
        "score": 2,
        "favourable_windows": [
          {
            "name": "labh",
            "start": "10:56",
            "end": "12:22",
            "minutes": 86
          },
          {
            "name": "abhijit",
            "start": "11:59",
            "end": "12:22",
            "minutes": 23
          }
        ],
        "abhijit_in_window": true,
        "tithi": "dashami",
        "tithi_group": "purna",
        "paksha": "krishna",
        "nakshatra": "magha",
        "nakshatra_group": "ugra",
        "yoga": "brahma",
        "karana": "vanija",
        "day_score": 32,
        "band": "avoid",
        "rejected": false,
        "rejections": []
      },
      {
        "date": "2026-11-10",
        "weekday": "tuesday",
        "score": 2,
        "favourable_windows": [
          {
            "name": "labh",
            "start": "10:57",
            "end": "12:22",
            "minutes": 85
          },
          {
            "name": "abhijit",
            "start": "12:00",
            "end": "12:22",
            "minutes": 22
          }
        ],
        "abhijit_in_window": true,
        "tithi": "pratipada",
        "tithi_group": "nanda",
        "paksha": "shukla",
        "nakshatra": "anuradha",
        "nakshatra_group": "mridu",
        "yoga": "shobhana",
        "karana": "bava",
        "day_score": 32,
        "band": "avoid",
        "rejected": false,
        "rejections": []
      },
      {
        "date": "2026-11-04",
        "weekday": "wednesday",
        "score": 0,
        "favourable_windows": [],
        "abhijit_in_window": false,
        "tithi": "ekadashi",
        "tithi_group": "nanda",
        "paksha": "krishna",
        "nakshatra": "purva_phalguni",
        "nakshatra_group": "ugra",
        "yoga": "indra",
        "karana": "bava",
        "day_score": 52,
        "band": "fair",
        "rejected": false,
        "rejections": []
      },
      {
        "date": "2026-11-09",
        "weekday": "monday",
        "score": 3,
        "favourable_windows": [
          {
            "name": "shubh",
            "start": "09:32",
            "end": "10:57",
            "minutes": 85
          },
          {
            "name": "abhijit",
            "start": "12:22",
            "end": "12:45",
            "minutes": 23
          },
          {
            "name": "labh",
            "start": "15:12",
            "end": "15:30",
            "minutes": 18
          }
        ],
        "abhijit_in_window": true,
        "tithi": "amavasya",
        "tithi_group": "purna",
        "paksha": "krishna",
        "nakshatra": "vishakha",
        "nakshatra_group": "mishra",
        "yoga": "saubhagya",
        "karana": "naga",
        "day_score": 24,
        "band": "avoid",
        "rejected": true,
        "rejections": [
          "amavasya"
        ]
      },
      {
        "date": "2026-11-13",
        "weekday": "friday",
        "score": 3,
        "favourable_windows": [
          {
            "name": "amrit",
            "start": "09:34",
            "end": "10:58",
            "minutes": 84
          },
          {
            "name": "abhijit",
            "start": "12:23",
            "end": "12:45",
            "minutes": 22
          },
          {
            "name": "shubh",
            "start": "12:23",
            "end": "13:47",
            "minutes": 84
          }
        ],
        "abhijit_in_window": true,
        "tithi": "chaturthi",
        "tithi_group": "rikta",
        "paksha": "shukla",
        "nakshatra": "mula",
        "nakshatra_group": "tikshna",
        "yoga": "dhriti",
        "karana": "vishti",
        "day_score": 8,
        "band": "avoid",
        "rejected": true,
        "rejections": [
          "rikta_tithi",
          "vishti_bhadra"
        ]
      },
      {
        "date": "2026-11-05",
        "weekday": "thursday",
        "score": 2,
        "favourable_windows": [
          {
            "name": "abhijit",
            "start": "11:59",
            "end": "12:45",
            "minutes": 46
          },
          {
            "name": "labh",
            "start": "12:22",
            "end": "13:47",
            "minutes": 85
          }
        ],
        "abhijit_in_window": true,
        "tithi": "dwadashi",
        "tithi_group": "bhadra",
        "paksha": "krishna",
        "nakshatra": "uttara_phalguni",
        "nakshatra_group": "dhruva",
        "yoga": "vaidhriti",
        "karana": "kaulava",
        "day_score": 58,
        "band": "avoid",
        "rejected": true,
        "rejections": [
          "vaidhriti_yoga"
        ]
      },
      {
        "date": "2026-11-11",
        "weekday": "wednesday",
        "score": 0,
        "favourable_windows": [],
        "abhijit_in_window": false,
        "tithi": "dwitiya",
        "tithi_group": "bhadra",
        "paksha": "shukla",
        "nakshatra": "jyeshtha",
        "nakshatra_group": "tikshna",
        "yoga": "atiganda",
        "karana": "kaulava",
        "day_score": 36,
        "band": "avoid",
        "rejected": true,
        "rejections": [
          "atiganda_yoga"
        ]
      }
    ],
    "scanned_days": 10,
    "excluded_days": 2
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.10.10",
    "mode": "live",
    "credits_charged": 3
  },
  "warnings": []
}
Try it

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one

More in Panchang & muhurat

Get a free API key Panchang & muhurat product page