AstroLogics API

API reference › Panchang & muhurat

Muhurat for a Day API

One day judged for an activity: the panchang, the verdict, the windows left after Rahu Kaal, Yamaganda and Gulika

GET/v1/muhurat/day

1 credit · Secret or publishable key · getMuhuratDay

activity is an id from GET /v1/muhurat/activities (anything else is 400). panchang and verdict come from the day-level judgement, sampled at 12:00 IST (panchang.at says the instant); sunrise, sunset, avoid and windows are the place's own, as ISO 8601 with the place's UTC offset. Night windows run past midnight into the next date. Refused where the Sun does not both rise and set.

Parameters

NameInTypeNotes
date requiredquerystring (date) e.g. "1990-08-13"
activity requiredquerystringAn activity id from GET /v1/muhurat/activities.
lat requiredquerynumber ≥ -90 · ≤ 90
lon requiredquerynumber ≥ -180 · ≤ 180

Response

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

  • date string (date) required

    e.g. "1990-08-13"

  • activity string required
  • weekday string required
  • panchang MuhuratPanchang required
    • 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
  • verdict object required
    • score number required
    • band string required
    • band_label string required
    • rejected boolean required
    • reasons array of string required
    • factors array of object required
      Fields
      • points number required
      • why string required
      • rule string required
  • sunrise string (date-time) required
  • sunset string (date-time) required
  • avoid array of object required
    • name string required
    • start string (date-time) required
    • end string (date-time) required
  • windows array of object required
    • 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

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

Example request

curl 'https://api.astrologics.in/v1/muhurat/day?date=2026-11-20&activity=marriage&lat=28.6139&lon=77.209' \
  -H 'Authorization: Bearer al_test_YOUR_KEY'
Node.js
const res = await fetch("https://api.astrologics.in/v1/muhurat/day?date=2026-11-20&activity=marriage&lat=28.6139&lon=77.209", {
  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/day?date=2026-11-20&activity=marriage&lat=28.6139&lon=77.209",
    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/day?date=2026-11-20&activity=marriage&lat=28.6139&lon=77.209');
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 · 3,560 characters
{
  "data": {
    "date": "2026-11-20",
    "activity": "marriage",
    "weekday": "friday",
    "panchang": {
      "at": "2026-11-20T06:30:00.000Z",
      "tithi": {
        "number": 11,
        "name": "ekadashi",
        "paksha": "shukla",
        "group": "nanda"
      },
      "nakshatra": {
        "number": 26,
        "name": "uttara_bhadrapada",
        "group": "dhruva"
      },
      "yoga": {
        "number": 15,
        "name": "vajra"
      },
      "karana": {
        "number": 21,
        "name": "vanija"
      },
      "moon_sign": {
        "number": 12,
        "name": "pisces"
      }
    },
    "verdict": {
      "score": 64,
      "band": "avoid",
      "band_label": "Avoid",
      "rejected": true,
      "reasons": [
        "Vajra yoga"
      ],
      "factors": [
        {
          "points": 16,
          "why": "Uttara Bhadrapada is named for this act",
          "rule": "ACTIVITIES.nakshatras"
        },
        {
          "points": -16,
          "why": "Vajra yoga is inauspicious",
          "rule": "YOGA_AVOID"
        },
        {
          "points": 8,
          "why": "Friday is a favourable weekday for it",
          "rule": "ACTIVITIES.varas"
        },
        {
          "points": 6,
          "why": "Ekadashi (nanda) carries no tithi objection",
          "rule": "TITHI_GROUP"
        }
      ]
    },
    "sunrise": "2026-11-20T06:48:00+05:30",
    "sunset": "2026-11-20T17:26:00+05:30",
    "avoid": [
      {
        "name": "Rahu Kaal",
        "start": "2026-11-20T10:47:00+05:30",
        "end": "2026-11-20T12:07:00+05:30"
      },
      {
        "name": "Yamaganda",
        "start": "2026-11-20T14:46:00+05:30",
        "end": "2026-11-20T16:06:00+05:30"
      },
      {
        "name": "Gulika",
        "start": "2026-11-20T08:07:00+05:30",
        "end": "2026-11-20T09:27:00+05:30"
      }
    ],
    "windows": [
      {
        "name": "Abhijit muhurat",
        "kind": "abhijit",
        "part_of_day": "day",
        "start": "2026-11-20T12:07:00+05:30",
        "end": "2026-11-20T12:28:00+05:30",
        "minutes": 21
      },
      {
        "name": "Amrit choghadiya",
        "kind": "choghadiya",
        "part_of_day": "day",
        "start": "2026-11-20T09:27:00+05:30",
        "end": "2026-11-20T10:47:00+05:30",
        "minutes": 80
      },
      {
        "name": "Shubh choghadiya",
        "kind": "choghadiya",
        "part_of_day": "day",
        "start": "2026-11-20T12:07:00+05:30",
        "end": "2026-11-20T13:26:00+05:30",
        "minutes": 79
      },
      {
        "name": "Shubh choghadiya",
        "kind": "choghadiya",
        "part_of_day": "night",
        "start": "2026-11-21T00:07:00+05:30",
        "end": "2026-11-21T01:47:00+05:30",
        "minutes": 100
      },
      {
        "name": "Amrit choghadiya",
        "kind": "choghadiya",
        "part_of_day": "night",
        "start": "2026-11-21T01:47:00+05:30",
        "end": "2026-11-21T03:27:00+05:30",
        "minutes": 100
      },
      {
        "name": "Labh choghadiya",
        "kind": "choghadiya",
        "part_of_day": "night",
        "start": "2026-11-20T20:46:00+05:30",
        "end": "2026-11-20T22:26:00+05:30",
        "minutes": 100
      }
    ],
    "note": "Rahu Kaal, Yamaganda and Gulika have already been cut out of the windows above — what is listed is what is left."
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.10.10",
    "mode": "live",
    "credits_charged": 1
  },
  "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