AstroLogics API

API reference › Panchang & muhurat

Muhurat Dates API for an Occasion

Every local day between two dates for an occasion: available with its windows, or the reason it is not

GET/v1/muhurat/{occasion}

2 credits · Secret or publishable key · getMuhuratDays

from and to are local dates at the place, at most 62 days apart (inclusive). Every day is returned: status available with its windows (ISO 8601 UTC; a window may cross local midnight), or unavailable with the first failing reason in the reference's order (reason is a machine id, message the text). Refused where the Sun does not rise on one of the days.

Parameters

NameInTypeNotes
occasion requiredpathstringvivah (marriage), grihapravesh (house-warming), vehicle (vehicle purchase), property (property purchase). one of vivah, grihapravesh, vehicle, property
from requiredquerystring (date) e.g. "1990-08-13"
to requiredquerystring (date) e.g. "1990-08-13"
lat requiredquerynumber ≥ -90 · ≤ 90
lon requiredquerynumber ≥ -180 · ≤ 180

Response

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

  • occasion string required

    one of vivah, grihapravesh, vehicle, property

  • place Coordinates required
    • latitude number required

      ≥ -90 · ≤ 90

    • longitude number required

      ≥ -180 · ≤ 180

  • from string (date) required

    e.g. "1990-08-13"

  • to string (date) required

    e.g. "1990-08-13"

  • days array of object required
    • date string (date) required

      e.g. "1990-08-13"

    • status string required

      one of available, unavailable

    • reason string required
    • message string required
    • windows array of object required
      Fields
      • start string (date-time) required
      • end string (date-time) required
      • nakshatra array of string required
      • tithi array of string required

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

Example request

curl 'https://api.astrologics.in/v1/muhurat/vivah?from=2026-11-01&to=2026-11-30&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/vivah?from=2026-11-01&to=2026-11-30&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/vivah?from=2026-11-01&to=2026-11-30&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/vivah?from=2026-11-01&to=2026-11-30&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 · 7,082 characters
{
  "data": {
    "occasion": "vivah",
    "place": {
      "latitude": 28.6139,
      "longitude": 77.209
    },
    "from": "2026-11-01",
    "to": "2026-11-30",
    "days": [
      {
        "date": "2026-11-01",
        "status": "unavailable",
        "reason": "chaturmas_full",
        "message": "Prohibited Chaturmas",
        "windows": []
      },
      {
        "date": "2026-11-02",
        "status": "unavailable",
        "reason": "chaturmas_full",
        "message": "Prohibited Chaturmas",
        "windows": []
      },
      {
        "date": "2026-11-03",
        "status": "unavailable",
        "reason": "chaturmas_full",
        "message": "Prohibited Chaturmas",
        "windows": []
      },
      {
        "date": "2026-11-04",
        "status": "unavailable",
        "reason": "chaturmas_full",
        "message": "Prohibited Chaturmas",
        "windows": []
      },
      {
        "date": "2026-11-05",
        "status": "unavailable",
        "reason": "chaturmas_full",
        "message": "Prohibited Chaturmas",
        "windows": []
      },
      {
        "date": "2026-11-06",
        "status": "unavailable",
        "reason": "chaturmas_full",
        "message": "Prohibited Chaturmas",
        "windows": []
      },
      {
        "date": "2026-11-07",
        "status": "unavailable",
        "reason": "chaturmas_full",
        "message": "Prohibited Chaturmas",
        "windows": []
      },
      {
        "date": "2026-11-08",
        "status": "unavailable",
        "reason": "chaturmas_full",
        "message": "Prohibited Chaturmas",
        "windows": []
      },
      {
        "date": "2026-11-09",
        "status": "unavailable",
        "reason": "chaturmas_full",
        "message": "Prohibited Chaturmas",
        "windows": []
      },
      {
        "date": "2026-11-10",
        "status": "unavailable",
        "reason": "chaturmas_full",
        "message": "Prohibited Chaturmas",
        "windows": []
      },
      {
        "date": "2026-11-11",
        "status": "unavailable",
        "reason": "chaturmas_full",
        "message": "Prohibited Chaturmas",
        "windows": []
      },
      {
        "date": "2026-11-12",
        "status": "unavailable",
        "reason": "chaturmas_full",
        "message": "Prohibited Chaturmas",
        "windows": []
      },
      {
        "date": "2026-11-13",
        "status": "unavailable",
        "reason": "chaturmas_full",
        "message": "Prohibited Chaturmas",
        "windows": []
      },
      {
        "date": "2026-11-14",
        "status": "unavailable",
        "reason": "chaturmas_full",
        "message": "Prohibited Chaturmas",
        "windows": []
      },
      {
        "date": "2026-11-15",
        "status": "unavailable",
        "reason": "chaturmas_full",
        "message": "Prohibited Chaturmas",
        "windows": []
      },
      {
        "date": "2026-11-16",
        "status": "unavailable",
        "reason": "chaturmas_full",
        "message": "Prohibited Chaturmas",
        "windows": []
      },
      {
        "date": "2026-11-17",
        "status": "unavailable",
        "reason": "chaturmas_full",
        "message": "Prohibited Chaturmas",
        "windows": []
      },
      {
        "date": "2026-11-18",
        "status": "unavailable",
        "reason": "chaturmas_full",
        "message": "Prohibited Chaturmas",
        "windows": []
      },
      {
        "date": "2026-11-19",
        "status": "unavailable",
        "reason": "chaturmas_full",
        "message": "Prohibited Chaturmas",
        "windows": []
      },
      {
        "date": "2026-11-20",
        "status": "unavailable",
        "reason": "chaturmas_partial",
        "message": "Day partially overlaps with Prohibited Chaturmas",
        "windows": []
      },
      {
        "date": "2026-11-21",
        "status": "available",
        "reason": "available",
        "message": "Auspicious Marriage Muhurat is Available",
        "windows": [
          {
            "start": "2026-11-21T01:18:00.000Z",
            "end": "2026-11-21T18:39:45.000Z",
            "nakshatra": [
              "uttara_bhadrapada",
              "revati"
            ],
            "tithi": [
              "dwadashi"
            ]
          }
        ]
      },
      {
        "date": "2026-11-22",
        "status": "unavailable",
        "reason": "nakshatra",
        "message": "Auspicious Nakshatra not Available",
        "windows": []
      },
      {
        "date": "2026-11-23",
        "status": "unavailable",
        "reason": "nakshatra",
        "message": "Auspicious Nakshatra not Available",
        "windows": []
      },
      {
        "date": "2026-11-24",
        "status": "available",
        "reason": "available",
        "message": "Auspicious Marriage Muhurat is Available",
        "windows": [
          {
            "start": "2026-11-24T17:56:00.000Z",
            "end": "2026-11-25T01:21:00.000Z",
            "nakshatra": [
              "rohini"
            ],
            "tithi": [
              "pratipada"
            ]
          }
        ]
      },
      {
        "date": "2026-11-25",
        "status": "available",
        "reason": "available",
        "message": "Auspicious Marriage Muhurat is Available",
        "windows": [
          {
            "start": "2026-11-25T01:21:00.000Z",
            "end": "2026-11-26T01:22:00.000Z",
            "nakshatra": [
              "rohini",
              "mrigashira"
            ],
            "tithi": [
              "pratipada",
              "dwitiya"
            ]
          }
        ]
      },
      {
        "date": "2026-11-26",
        "status": "available",
        "reason": "available",
        "message": "Auspicious Marriage Muhurat is Available",
        "windows": [
          {
            "start": "2026-11-26T01:22:00.000Z",
            "end": "2026-11-26T12:18:00.000Z",
            "nakshatra": [
              "mrigashira"
            ],
            "tithi": [
              "dwitiya",
              "tritiya"
            ]
          }
        ]
      },
      {
        "date": "2026-11-27",
        "status": "unavailable",
        "reason": "nakshatra",
        "message": "Auspicious Nakshatra not Available",
        "windows": []
      },
      {
        "date": "2026-11-28",
        "status": "unavailable",
        "reason": "nakshatra",
        "message": "Auspicious Nakshatra not Available",
        "windows": []
      },
      {
        "date": "2026-11-29",
        "status": "unavailable",
        "reason": "nakshatra",
        "message": "Auspicious Nakshatra not Available",
        "windows": []
      },
      {
        "date": "2026-11-30",
        "status": "unavailable",
        "reason": "yoga",
        "message": "Prohibited Yoga is corrupting Auspicious Nakshatra",
        "windows": []
      }
    ]
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.10.10",
    "mode": "live",
    "credits_charged": 2
  },
  "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