API reference › Panchang & muhurat

Daily Panchang API for a Date and Place

Panchang for a date and place

GET/v1/panchang

1 credit · Secret or publishable key · getPanchang

Tithi, nakshatra, yoga, karana, vara; sunrise, sunset; Rahu Kaal, Gulika, Yamaganda, Abhijit. tithi.ends_at and nakshatra.ends_at: when the tithi and the nakshatra running at local noon end, ISO 8601 on the place's clock, to the minute (null when the engine finds no end). Every tithi of a range with its start: GET /v1/calendar/tithis. End times of yoga and karana, and moonrise, are not computed. nakshatra.weight is the engine's per-nakshatra weighting of the day (-0.22 to 0.25).

Parameters

NameInTypeNotes
date requiredquerystring (date) e.g. "1990-08-13"
latquerynumberWith lon; or use place_id. ≥ -90 · ≤ 90
lonquerynumber ≥ -180 · ≤ 180
place_idquerystring
langquerystring one of en, hi · default "en"
tonequerystringdescriptive: reviewed descriptive sentences in the prose fields, in lang; ids and values unchanged (as options.tone). one of default, descriptive · default "default"

Response

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

  • date string (date) required

    e.g. "1990-08-13"

  • place Coordinates required
    • latitude number required

      ≥ -90 · ≤ 90

    • longitude number required

      ≥ -180 · ≤ 180

  • timezone object required
    • name string required
    • utc_offset string required
  • tithi object required
    • number integer required

      ≥ 1 · ≤ 30

    • name string required
    • label string required
    • paksha string required
    • ends_at string (date-time) or null required

      One of:

      1. string (date-time)
      2. null
    • note string required

      The engine's one-line character of the tithi (e.g. 'Good - results take shape').

    • note_id string required

      A stable id for note: the same sentence always has the same id, so a client can show its own reviewed copy in its place (D3, 2026-10-29).

  • nakshatra object required
    • name 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

    • label string required
    • lord string required
    • next 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

    • ends_at string (date-time) or null required

      One of:

      1. string (date-time)
      2. null
    • number integer required

      ≥ 1 · ≤ 27

    • hours_remaining number or null required

      One of:

      1. number
      2. null
    • weight number required

      The engine's weighting of the Moon's nakshatra for the day, from -0.22 (Ardra, Mula) to 0.25 (Pushya); astrologics.in files it with its nakshatra alerts.

      ≥ -1 · ≤ 1

  • yoga object required
    • name string required
    • label string required
    • quality string required
    • number integer required

      ≥ 1 · ≤ 27

  • karana object required
    • number integer required

      ≥ 1 · ≤ 60

    • name string required
    • label string required
  • vara object required
    • name string required
    • label string required
    • lord string required
  • sunrise string (date-time) required
  • sunset string (date-time) required
  • rahu_kaal TimeWindow or null required

    One of:

    1. TimeWindow
      Fields
      • start string (date-time) required
      • end string (date-time) required
    2. null
  • gulika_kaal TimeWindow or null required

    One of:

    1. TimeWindow
      Fields
      • start string (date-time) required
      • end string (date-time) required
    2. null
  • yamaganda TimeWindow or null required

    One of:

    1. TimeWindow
      Fields
      • start string (date-time) required
      • end string (date-time) required
    2. null
  • abhijit TimeWindow or null required

    One of:

    1. TimeWindow
      Fields
      • start string (date-time) required
      • end string (date-time) required
    2. null

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

Example request

curl 'https://api.astrologics.in/v1/panchang?date=2026-10-02&lat=28.6139&lon=77.209' \
  -H 'Authorization: Bearer al_test_YOUR_KEY'
Node.js
const res = await fetch("https://api.astrologics.in/v1/panchang?date=2026-10-02&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/panchang?date=2026-10-02&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/panchang?date=2026-10-02&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 · 1,716 characters
{
  "data": {
    "date": "2026-10-02",
    "place": {
      "latitude": 28.6139,
      "longitude": 77.209
    },
    "timezone": {
      "name": "Asia/Kolkata",
      "utc_offset": "+05:30"
    },
    "tithi": {
      "number": 22,
      "name": "saptami",
      "label": "Saptami",
      "paksha": "krishna",
      "ends_at": "2026-10-03T08:00:00+05:30",
      "note": "Positive - a day for action",
      "note_id": "tithi_saptami"
    },
    "nakshatra": {
      "name": "mrigashira",
      "label": "Mrigashira",
      "lord": "mars",
      "next": "ardra",
      "ends_at": "2026-10-03T02:55:00+05:30",
      "weight": 0.05,
      "number": 5,
      "hours_remaining": 14.9
    },
    "yoga": {
      "name": "vyatipata",
      "label": "Vyatipata",
      "quality": "inauspicious",
      "number": 17
    },
    "karana": {
      "number": 43,
      "name": "vishti",
      "label": "Vishti"
    },
    "vara": {
      "name": "shukravara",
      "label": "Shukravara",
      "lord": "venus"
    },
    "sunrise": "2026-10-02T06:15:00+05:30",
    "sunset": "2026-10-02T18:06:00+05:30",
    "rahu_kaal": {
      "start": "2026-10-02T10:41:00+05:30",
      "end": "2026-10-02T12:10:00+05:30"
    },
    "gulika_kaal": {
      "start": "2026-10-02T07:43:00+05:30",
      "end": "2026-10-02T09:12:00+05:30"
    },
    "yamaganda": {
      "start": "2026-10-02T15:08:00+05:30",
      "end": "2026-10-02T16:37:00+05:30"
    },
    "abhijit": {
      "start": "2026-10-02T11:47:00+05:30",
      "end": "2026-10-02T12:34:00+05:30"
    }
  },
  "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