Muhurat Search API

Days rated for an activity, with scores and rejection reasons

GET/v1/muhurat/search

2 credits · Secret key (test or live) · searchMuhurat

Every day from from to to (1–400 days) judged for the activity at 12:00 IST: score, band, the hard rejections, the panchang, the factors that moved the score. With janma_nakshatra (1–27) and/or janma_rashi (1–12) the days are personalised with tara bala and chandra bala. best: the top usable days (top, default 10, by score then date) with the windows left after Rahu Kaal, Yamaganda and Gulika, on the place's clock.

Parameters

Name	In	Type	Notes
`activity` required	query	string
`from` required	query	string (date)	e.g. `"1990-08-13"`
`to` required	query	string (date)	e.g. `"1990-08-13"`
`lat`	query	number	With lon; or use place_id. ≥ -90 · ≤ 90
`lon`	query	number	≥ -180 · ≤ 180
`place_id`	query	string
`limit`	query	integer	≥ 1 · ≤ 100 · default `20`
`cursor`	query	string
`janma_nakshatra`	query	integer	The birth nakshatra (1 Ashwini … 27 Revati): adds tara bala. ≥ 1 · ≤ 27
`janma_rashi`	query	integer	The birth Moon sign (1 Aries … 12 Pisces): adds chandra bala. ≥ 1 · ≤ 12
`top`	query	integer	How many of the best usable days get their windows. ≥ 1 · ≤ 90 · default `10`

Response

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

activity string required
days array of object required
- date string (date) required
  e.g. "1990-08-13"
- score number required
- band string required
- rejected boolean required
- reasons array of string required
- weekday string required
- band_id string required
- panchang MuhuratPanchang required
  Fields
  - at string (date-time) required
  - tithi object required
    Fields
    number integer required
    ≥ 1 · ≤ 30
    
    name string required
    paksha string required
    group string required
  - nakshatra object required
    Fields
    number integer required
    ≥ 1 · ≤ 27
    
    name string required
    group string required
  - yoga object required
    Fields
    number integer required
    ≥ 1 · ≤ 27
    
    name string required
  - karana object required
    Fields
    number integer required
    ≥ 1 · ≤ 60
    
    name string required
  - moon_sign object required
    Fields
    number integer required
    ≥ 1 · ≤ 12
    
    name string required
- factors array of object required
  Fields
  - points number required
  - why string required
  - rule string required
- in_panchak boolean required
- panchak_applies boolean required
- tara_bala object or null required
  One of:
  1. object
    Fields
    - count integer required
      ≥ 1 · ≤ 27
    - tara integer required
      ≥ 1 · ≤ 9
    - name string required
    - label string required
    - good boolean required
    - bad boolean required
    - note string or null required
      One of:
      string
      null
  2. null
- chandra_bala object or null required
  One of:
  1. object
    Fields
    - from integer required
      ≥ 1 · ≤ 12
    - good boolean required
    - bad boolean required
  2. null
- personalised boolean required
activity_info object required
- label string required
- label_hi string required
- note string required
from string (date) required
e.g. "1990-08-13"
day_count integer required
≥ 1
place Coordinates required
- latitude number required
  ≥ -90 · ≤ 90
- longitude number required
  ≥ -180 · ≤ 180
personalised boolean required
janma_nakshatra object or null required
One of:
1. object
  Fields
  - number integer required
    ≥ 1 · ≤ 27
  - name string required
2. null
janma_rashi object or null required
One of:
1. object
  Fields
  - number integer required
    ≥ 1 · ≤ 12
  - name string required
2. null
counts object required
- scanned integer required
- usable integer required
- rejected integer required
best array of object required
- date string (date) required
  e.g. "1990-08-13"
- times MuhuratTimes required
  Fields
  - sunrise string (date-time) required
  - sunset string (date-time) required
  - avoid array of object required
    Fields
    name string required
    start string (date-time) required
    end string (date-time) required
  - windows array of object required
    Fields
    name string required
    start string (date-time) required
    end string (date-time) required
    kind string required
    one of abhijit, choghadiya
    
    part_of_day string required
    one of day, night
    
    minutes integer required
    ≥ 1
  - note string required
advisories array of object required
- key string required
- en string required
- hi string required
disclosure object required
- en string required
- hi string required
panchak_acts array of string required

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

Example request

curl 'https://api.astrologics.in/v1/muhurat/search?activity=marriage&from=2026-10-01&to=2026-10-07&lat=28.6139&lon=77.209&top=2' \
  -H 'Authorization: Bearer al_test_YOUR_KEY'

Node.js

const res = await fetch("https://api.astrologics.in/v1/muhurat/search?activity=marriage&from=2026-10-01&to=2026-10-07&lat=28.6139&lon=77.209&top=2", {
  headers: { Authorization: "Bearer al_test_YOUR_KEY" },
});
console.log(JSON.stringify(await res.json(), null, 2));

Python

import json
import urllib.error
import urllib.request

req = urllib.request.Request(
    "https://api.astrologics.in/v1/muhurat/search?activity=marriage&from=2026-10-01&to=2026-10-07&lat=28.6139&lon=77.209&top=2",
    method="GET",
    headers={"Authorization": "Bearer al_test_YOUR_KEY"},
)
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/search?activity=marriage&from=2026-10-01&to=2026-10-07&lat=28.6139&lon=77.209&top=2');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY'],
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 19,202 characters

{
  "data": {
    "activity": "marriage",
    "days": [
      {
        "date": "2026-10-01",
        "score": 80,
        "band": "Excellent",
        "rejected": false,
        "reasons": [],
        "weekday": "thursday",
        "band_id": "excellent",
        "panchang": {
          "at": "2026-10-01T06:30:00.000Z",
          "tithi": {
            "number": 20,
            "name": "panchami",
            "paksha": "krishna",
            "group": "purna"
          },
          "nakshatra": {
            "number": 4,
            "name": "rohini",
            "group": "dhruva"
          },
          "yoga": {
            "number": 16,
            "name": "siddhi"
          },
          "karana": {
            "number": 40,
            "name": "taitila"
          },
          "moon_sign": {
            "number": 2,
            "name": "taurus"
          }
        },
        "factors": [
          {
            "points": 16,
            "why": "Rohini is named for this act",
            "rule": "ACTIVITIES.nakshatras"
          },
          {
            "points": 8,
            "why": "Thursday is a favourable weekday for it",
            "rule": "ACTIVITIES.varas"
          },
          {
            "points": 6,
            "why": "Panchami (purna) carries no tithi objection",
            "rule": "TITHI_GROUP"
          }
        ],
        "in_panchak": false,
        "panchak_applies": false,
        "tara_bala": null,
        "chandra_bala": null,
        "personalised": false
      },
      {
        "date": "2026-10-02",
        "score": 44,
        "band": "Avoid",
        "rejected": true,
        "reasons": [
          "Vyatipata yoga",
          "Vishti (Bhadra)"
        ],
        "weekday": "friday",
        "band_id": "avoid",
        "panchang": {
          "at": "2026-10-02T06:30:00.000Z",
          "tithi": {
            "number": 22,
            "name": "saptami",
            "paksha": "krishna",
            "group": "bhadra"
          },
          "nakshatra": {
            "number": 5,
            "name": "mrigashira",
            "group": "mridu"
          },
          "yoga": {
            "number": 17,
            "name": "vyatipata"
          },
          "karana": {
            "number": 43,
            "name": "vishti"
          },
          "moon_sign": {
            "number": 2,
            "name": "taurus"
          }
        },
        "factors": [
          {
            "points": -20,
            "why": "Vishti (Bhadra) karana — avoided for auspicious work",
            "rule": "KARANA_AVOID"
          },
          {
            "points": 16,
            "why": "Mrigashira is named for this act",
            "rule": "ACTIVITIES.nakshatras"
          },
          {
            "points": -16,
            "why": "Vyatipata yoga is inauspicious",
            "rule": "YOGA_AVOID"
          },
          {
            "points": 8,
            "why": "Friday is a favourable weekday for it",
            "rule": "ACTIVITIES.varas"
          },
          {
            "points": 6,
            "why": "Saptami (bhadra) carries no tithi objection",
            "rule": "TITHI_GROUP"
          }
        ],
        "in_panchak": false,
        "panchak_applies": false,
        "tara_bala": null,
        "chandra_bala": null,
        "personalised": false
      },
      {
        "date": "2026-10-03",
        "score": 32,
        "band": "Avoid",
        "rejected": false,
        "reasons": [],
        "weekday": "saturday",
        "band_id": "avoid",
        "panchang": {
          "at": "2026-10-03T06:30:00.000Z",
          "tithi": {
            "number": 23,
            "name": "ashtami",
            "paksha": "krishna",
            "group": "jaya"
          },
          "nakshatra": {
            "number": 6,
            "name": "ardra",
            "group": "tikshna"
          },
          "yoga": {
            "number": 18,
            "name": "variyan"
          },
          "karana": {
            "number": 45,
            "name": "balava"
          },
          "moon_sign": {
            "number": 3,
            "name": "gemini"
          }
        },
        "factors": [
          {
            "points": -12,
            "why": "Ardra is a tikshna star, set aside for this act",
            "rule": "NAK_GROUP"
          },
          {
            "points": -12,
            "why": "Saturday is set aside for this act",
            "rule": "ACTIVITIES.avoidVaras"
          },
          {
            "points": 6,
            "why": "Ashtami (jaya) carries no tithi objection",
            "rule": "TITHI_GROUP"
          }
        ],
        "in_panchak": false,
        "panchak_applies": false,
        "tara_bala": null,
        "chandra_bala": null,
        "personalised": false
      },
      {
        "date": "2026-10-04",
        "score": 4,
        "band": "Avoid",
        "rejected": true,
        "reasons": [
          "Rikta tithi",
          "Parigha yoga"
        ],
        "weekday": "sunday",
        "band_id": "avoid",
        "panchang": {
          "at": "2026-10-04T06:30:00.000Z",
          "tithi": {
            "number": 24,
            "name": "navami",
            "paksha": "krishna",
            "group": "rikta"
          },
          "nakshatra": {
            "number": 7,
            "name": "punarvasu",
            "group": "chara"
          },
          "yoga": {
            "number": 19,
            "name": "parigha"
          },
          "karana": {
            "number": 47,
            "name": "taitila"
          },
          "moon_sign": {
            "number": 3,
            "name": "gemini"
          }
        },
        "factors": [
          {
            "points": -18,
            "why": "Navami is a Rikta tithi — rejected for beginnings",
            "rule": "TITHI_AVOID"
          },
          {
            "points": -16,
            "why": "Parigha yoga is inauspicious",
            "rule": "YOGA_AVOID"
          },
          {
            "points": -12,
            "why": "Punarvasu is a chara star, set aside for this act",
            "rule": "NAK_GROUP"
          }
        ],
        "in_panchak": false,
        "panchak_applies": false,
        "tara_bala": null,
        "chandra_bala": null,
        "personalised": false
      },
      {
        "date": "2026-10-05",
        "score": 52,
        "band": "Fair",
        "rejected": false,
        "reasons": [],
        "weekday": "monday",
        "band_id": "fair",
        "panchang": {
          "at": "2026-10-05T06:30:00.000Z",
          "tithi": {
            "number": 25,
            "name": "dashami",
            "paksha": "krishna",
            "group": "purna"
          },
          "nakshatra": {
            "number": 8,
            "name": "pushya",
            "group": "kshipra"
          },
          "yoga": {
            "number": 21,
            "name": "siddha"
          },
          "karana": {
            "number": 49,
            "name": "vanija"
          },
          "moon_sign": {
            "number": 4,
            "name": "cancer"
          }
        },
        "factors": [
          {
            "points": -12,
            "why": "Pushya is a kshipra star, set aside for this act",
            "rule": "NAK_GROUP"
          },
          {
            "points": 8,
            "why": "Monday is a favourable weekday for it",
            "rule": "ACTIVITIES.varas"
          },
          {
            "points": 6,
            "why": "Dashami (purna) carries no tithi objection",
            "rule": "TITHI_GROUP"
          }
        ],
        "in_panchak": false,
        "panchak_applies": false,
        "tara_bala": null,
        "chandra_bala": null,
        "personalised": false
      },
      {
        "date": "2026-10-06",
        "score": 32,
        "band": "Avoid",
        "rejected": false,
        "reasons": [],
        "weekday": "tuesday",
        "band_id": "avoid",
        "panchang": {
          "at": "2026-10-06T06:30:00.000Z",
          "tithi": {
            "number": 26,
            "name": "ekadashi",
            "paksha": "krishna",
            "group": "nanda"
          },
          "nakshatra": {
            "number": 9,
            "name": "ashlesha",
            "group": "tikshna"
          },
          "yoga": {
            "number": 22,
            "name": "sadhya"
          },
          "karana": {
            "number": 51,
            "name": "bava"
          },
          "moon_sign": {
            "number": 4,
            "name": "cancer"
          }
        },
        "factors": [
          {
            "points": -12,
            "why": "Ashlesha is a tikshna star, set aside for this act",
            "rule": "NAK_GROUP"
          },
          {
            "points": -12,
            "why": "Tuesday is set aside for this act",
            "rule": "ACTIVITIES.avoidVaras"
          },
          {
            "points": 6,
            "why": "Ekadashi (nanda) carries no tithi objection",
            "rule": "TITHI_GROUP"
          }
        ],
        "in_panchak": false,
        "panchak_applies": false,
        "tara_bala": null,
        "chandra_bala": null,
        "personalised": false
      },
      {
        "date": "2026-10-07",
        "score": 52,
        "band": "Fair",
        "rejected": false,
        "reasons": [],
        "weekday": "wednesday",
        "band_id": "fair",
        "panchang": {
          "at": "2026-10-07T06:30:00.000Z",
          "tithi": {
            "number": 27,
            "name": "dwadashi",
            "paksha": "krishna",
            "group": "bhadra"
          },
          "nakshatra": {
            "number": 10,
            "name": "magha",
            "group": "ugra"
          },
          "yoga": {
            "number": 23,
            "name": "shubha"
          },
          "karana": {
            "number": 54,
            "name": "taitila"
          },
          "moon_sign": {
            "number": 5,
            "name": "leo"
          }
        },
        "factors": [
          {
            "points": -12,
            "why": "Magha is a ugra star, set aside for this act",
            "rule": "NAK_GROUP"
          },
          {
            "points": 8,
            "why": "Wednesday is a favourable weekday for it",
            "rule": "ACTIVITIES.varas"
          },
          {
            "points": 6,
            "why": "Dwadashi (bhadra) carries no tithi objection",
            "rule": "TITHI_GROUP"
          }
        ],
        "in_panchak": false,
        "panchak_applies": false,
        "tara_bala": null,
        "chandra_bala": null,
        "personalised": false
      }
    ],
    "activity_info": {
      "label": "Marriage / engagement",
      "label_hi": "विवाह / सगाई",
      "note": "Rohini, Mrigashira, the three Uttaras, Hasta, Swati, Anuradha, Moola, Revati are the stars named for marriage."
    },
    "from": "2026-10-01",
    "day_count": 7,
    "place": {
      "latitude": 28.6139,
      "longitude": 77.209
    },
    "personalised": false,
    "janma_nakshatra": null,
    "janma_rashi": null,
    "counts": {
      "scanned": 7,
      "usable": 5,
      "rejected": 2
    },
    "best": [
      {
        "date": "2026-10-01",
        "times": {
          "sunrise": "2026-10-01T06:14:00+05:30",
          "sunset": "2026-10-01T18:07:00+05:30",
          "avoid": [
            {
              "name": "Rahu Kaal",
              "start": "2026-10-01T13:40:00+05:30",
              "end": "2026-10-01T15:09:00+05:30"
            },
            {
              "name": "Yamaganda",
              "start": "2026-10-01T06:14:00+05:30",
              "end": "2026-10-01T07:43:00+05:30"
            },
            {
              "name": "Gulika",
              "start": "2026-10-01T09:12:00+05:30",
              "end": "2026-10-01T10:42:00+05:30"
            }
          ],
          "windows": [
            {
              "name": "Abhijit muhurat",
              "kind": "abhijit",
              "part_of_day": "day",
              "start": "2026-10-01T11:47:00+05:30",
              "end": "2026-10-01T12:34:00+05:30",
              "minutes": 47
            },
            {
              "name": "Labh choghadiya",
              "kind": "choghadiya",
              "part_of_day": "day",
              "start": "2026-10-01T12:11:00+05:30",
              "end": "2026-10-01T13:40:00+05:30",
              "minutes": 89
            },
            {
              "name": "Shubh choghadiya",
              "kind": "choghadiya",
              "part_of_day": "day",
              "start": "2026-10-01T16:38:00+05:30",
              "end": "2026-10-01T18:07:00+05:30",
              "minutes": 89
            },
            {
              "name": "Labh choghadiya",
              "kind": "choghadiya",
              "part_of_day": "night",
              "start": "2026-10-02T00:11:00+05:30",
              "end": "2026-10-02T01:42:00+05:30",
              "minutes": 91
            },
            {
              "name": "Shubh choghadiya",
              "kind": "choghadiya",
              "part_of_day": "night",
              "start": "2026-10-02T03:12:00+05:30",
              "end": "2026-10-02T04:43:00+05:30",
              "minutes": 91
            },
            {
              "name": "Amrit choghadiya",
              "kind": "choghadiya",
              "part_of_day": "night",
              "start": "2026-10-02T04:43:00+05:30",
              "end": "2026-10-02T06:14:00+05:30",
              "minutes": 91
            },
            {
              "name": "Amrit choghadiya",
              "kind": "choghadiya",
              "part_of_day": "night",
              "start": "2026-10-01T18:07:00+05:30",
              "end": "2026-10-01T19:38:00+05:30",
              "minutes": 91
            }
          ],
          "note": "Rahu Kaal, Yamaganda and Gulika have already been cut out of the windows above — what is listed is what is left."
        }
      },
      {
        "date": "2026-10-05",
        "times": {
          "sunrise": "2026-10-05T06:16:00+05:30",
          "sunset": "2026-10-05T18:03:00+05:30",
          "avoid": [
            {
              "name": "Rahu Kaal",
              "start": "2026-10-05T07:44:00+05:30",
              "end": "2026-10-05T09:13:00+05:30"
            },
            {
              "name": "Yamaganda",
              "start": "2026-10-05T10:41:00+05:30",
              "end": "2026-10-05T12:09:00+05:30"
            },
            {
              "name": "Gulika",
              "start": "2026-10-05T13:38:00+05:30",
              "end": "2026-10-05T15:06:00+05:30"
            }
          ],
          "windows": [
            {
              "name": "Abhijit muhurat",
              "kind": "abhijit",
              "part_of_day": "day",
              "start": "2026-10-05T12:09:00+05:30",
              "end": "2026-10-05T12:33:00+05:30",
              "minutes": 24
            },
            {
              "name": "Amrit choghadiya",
              "kind": "choghadiya",
              "part_of_day": "day",
              "start": "2026-10-05T06:16:00+05:30",
              "end": "2026-10-05T07:44:00+05:30",
              "minutes": 88
            },
            {
              "name": "Shubh choghadiya",
              "kind": "choghadiya",
              "part_of_day": "day",
              "start": "2026-10-05T09:13:00+05:30",
              "end": "2026-10-05T10:41:00+05:30",
              "minutes": 88
            },
            {
              "name": "Labh choghadiya",
              "kind": "choghadiya",
              "part_of_day": "day",
              "start": "2026-10-05T15:06:00+05:30",
              "end": "2026-10-05T16:34:00+05:30",
              "minutes": 88
            },
            {
              "name": "Amrit choghadiya",
              "kind": "choghadiya",
              "part_of_day": "day",
              "start": "2026-10-05T16:34:00+05:30",
              "end": "2026-10-05T18:03:00+05:30",
              "minutes": 89
            },
            {
              "name": "Shubh choghadiya",
              "kind": "choghadiya",
              "part_of_day": "night",
              "start": "2026-10-06T01:41:00+05:30",
              "end": "2026-10-06T03:13:00+05:30",
              "minutes": 92
            },
            {
              "name": "Amrit choghadiya",
              "kind": "choghadiya",
              "part_of_day": "night",
              "start": "2026-10-06T03:13:00+05:30",
              "end": "2026-10-06T04:44:00+05:30",
              "minutes": 91
            }
          ],
          "note": "Rahu Kaal, Yamaganda and Gulika have already been cut out of the windows above — what is listed is what is left."
        }
      }
    ],
    "advisories": [
      {
        "key": "guruShukraAsta",
        "en": "Marriage is traditionally not held while Jupiter or Venus is combust (asta). This report does not compute combustion — check it separately.",
        "hi": "गुरु या शुक्र के अस्त होने पर विवाह वर्जित माना जाता है। यह गणना इस रिपोर्ट में सम्मिलित नहीं है।"
      },
      {
        "key": "kharmas",
        "en": "Kharmas / Malamasa (the Sun in Sagittarius or Pisces, and an adhika month) bars auspicious beginnings in most traditions. Not computed here.",
        "hi": "खरमास/मलमास में शुभ कार्य वर्जित माने जाते हैं। यह गणना यहाँ सम्मिलित नहीं है।"
      },
      {
        "key": "chaturmas",
        "en": "Chaturmas — the four months from Devshayani to Devuthani Ekadashi — is avoided for marriage and housewarming by many families. Not computed here.",
        "hi": "चातुर्मास में विवाह व गृह प्रवेश अनेक परिवारों में वर्जित हैं। यह गणना यहाँ सम्मिलित नहीं है।"
      },
      {
        "key": "lagnaShuddhi",
        "en": "A full muhurta also examines the rising sign of the chosen moment (lagna shuddhi). This report scores the panchang and the day's windows, not the lagna.",
        "hi": "पूर्ण मुहूर्त में चुने गए क्षण का लग्न भी देखा जाता है, जो इस रिपोर्ट में सम्मिलित नहीं है।"
      }
    ],
    "disclosure": {
      "en": "Muhurat here is read from the panchang — tithi, vara, nakshatra, yoga and karana — together with the day's Rahu Kaal, Yamaganda and Gulika windows, and (when your birth star is known) tara bala and chandra bala. The classical texts accept or reject a day; the 0-100 figure is ours, and it only says how strongly the day agrees with what this act traditionally asks for. It is not a probability, and it does not replace a family astrologer.",
      "hi": "यहाँ मुहूर्त पंचांग से देखा गया है — तिथि, वार, नक्षत्र, योग व करण, साथ ही राहुकाल, यमगंड व गुलिक काल, और जन्म नक्षत्र ज्ञात होने पर तारा बल व चंद्र बल। शास्त्र दिन को स्वीकार या अस्वीकार करते हैं; 0-100 अंक हमारा है और केवल यह बताता है कि दिन इस कार्य की शास्त्रीय अपेक्षाओं से कितना मेल खाता है।"
    },
    "panchak_acts": [
      "roofing a house",
      "travelling south",
      "gathering wood or fuel",
      "making a bed",
      "last rites"
    ]
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.10.10",
    "mode": "live",
    "credits_charged": 2
  },
  "warnings": []
}

Try it

Test key (optional)

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

activity (query)

from (query)

to (query)

lat (query)

lon (query)

place_id (query)

limit (query)

cursor (query)

janma_nakshatra (query)

janma_rashi (query)

top (query)

Muhurat Search API

Parameters

Response

Example request

Example response

More in Panchang & muhurat