LifeAstroAPILifeAstroAPI

API Reference / Vedic Astrology / Panchang

GET
30 credits

/v1/panchang/advanced

Complete daily panchang: all 5 elements + muhurta windows (Rahu Kaal/Gulika/Abhijit/Brahma Muhurat) + Choghadiya + Hindu month + Samvat + Disha Shool + Nak Shool + Moon Nivas + Panchang Yogas + same-day transitions.

What this tells you

The `advanced` endpoint is a complete daily panchang in a single call. One response includes the five elements with end times, rise and set times, Sun and Moon signs, the Hindu month in both conventions, samvat and samvatsara, ritu and ayana, Disha Shool, Nak Shool, Moon Nivas, tithi and nakshatra metadata, special yogas, the next tithi, nakshatra and yoga when they change before the next sunrise, five muhurta windows (Rahu Kaal, Yamaganda, Gulika, Abhijit, Brahma Muhurat), 16 Choghadiya slots, Durmuhurta, Varjyam and Amrit Kalam. It does not include Hora; use /v1/panchang/hora for that.

Request

All requests require an Authorization header with your dv_live_* API key.

example request
curl "https://api.lifeastroapi.com/v1/panchang/advanced?date=2027-01-15&tz=Asia%2FKolkata&lat=28.6139&lon=77.209" \
  -H "Authorization: Bearer YOUR_API_KEY"

Query parameters

Checked against the API: a parameter is marked required when the request fails without it.

NameRequiredExampleDescription
dateyes2027-01-15Date (YYYY-MM-DD).
tzyesAsia/KolkataTimezone: IANA name (Asia/Kolkata) or UTC offset (+05:30).
latyes28.6139Latitude in decimal degrees.
lonyes77.209Longitude in decimal degrees.

Response (200 OK)

The real response to the example request above, generated from the API itself. Long arrays are trimmed to their first two items. Field names are stable across versions.

200 response
{
  "date": "2027-01-15",
  "location": {
    "lat": 28.6139,
    "lon": 77.209,
    "alt": 0
  },
  "tz": "Asia/Kolkata",
  "sunrise_jd": 2461420.572762,
  "sunrise_local": "2027-01-15 07:14:47",
  "sunset_jd": 2461421.011285,
  "sunset_local": "2027-01-15 17:46:15",
  "moonrise_jd": 2461420.740844,
  "moonrise_local": "2027-01-15 11:16:49",
  "moonset_jd": 2461421.295876,
  "moonset_local": "2027-01-16 00:36:04",
  "has_moonrise": true,
  "has_moonset": true,
  "tithi": {
    "index": 6,
    "name": "Saptami",
    "paksha": "Shukla",
    "tithi_in_paksha": 7,
    "end_jd": 2461420.863881,
    "end_local": "2027-01-15 14:13:59"
  },
  "nakshatra": {
    "index": 26,
    "name": "Revati",
    "pada": 2,
    "end_jd": 2461421.264565,
    "end_local": "2027-01-15 23:50:58"
  },
  "yoga": {
    "index": 19,
    "name": "Shiva",
    "end_jd": 2461420.949764,
    "end_local": "2027-01-15 16:17:40"
  },
  "karana": [
    {
      "index": 13,
      "name": "Vanija",
      "deity": "Lakshmi",
      "special": "Good for trade and commerce",
      "end_jd": 2461420.863881,
      "end_local": "2027-01-15 14:13:59"
    },
    {
      "index": 14,
      "name": "Vishti",
      "deity": "Yama",
      "special": "Very inauspicious; avoid all important works",
      "end_jd": 2461421.357302,
      "end_local": "2027-01-16 02:04:31"
    }
  ],
  "vara": {
    "weekday": "Friday",
    "weekday_index": 5,
    "lord": "Venus",
    "hindi_name": "शुक्रवार"
  },
  "sun_sign": "Capricorn",
  "sun_sign_index": 9,
  "moon_sign": "Pisces",
  "moon_sign_index": 11,
  "hindu_month": {
    "index": 9,
    "name": "Pausha",
    "display_name": "Pausha",
    "is_adhika": false,
    "paksha": "Shukla",
    "name_amanta": "Pausha",
    "name_purnimanta": "Pausha"
  },
  "calendar_context": {
    "ritu": "Hemanta",
    "ritu_hi": "हेमंत",
    "ayana": "Uttarayana",
    "ayana_hi": "उत्तरायण",
    "samvat_vikram": 2083,
    "samvat_shaka": 1948,
    "samvatsara_name": "Siddharthi",
    "samvatsara_name_hi": "सिद्धार्थी"
  },
  "disha_shool": {
    "direction": "West",
    "direction_hi": "पश्चिम",
    "remedy": "Eat curd (dahi) before traveling"
  },
  "nak_shool": {
    "direction": "none",
    "remedy": ""
  },
  "moon_nivas": {
    "direction": "South"
  },
  "tithi_meta": {
    "deity": "Surya",
    "type": "Bhadra"
  },
  "nakshatra_meta": {
    "ruling_planet": "Mercury",
    "deity": "Pushan",
    "gana": "Deva"
  },
  "panchang_yogas": [
    {
      "name": "Amrit Siddhi",
      "vara": "Friday",
      "trigger": "Revati nakshatra"
    },
    {
      "name": "Sarvartha Siddhi",
      "vara": "Friday",
      "trigger": "Revati nakshatra"
    }
  ],
  "next_tithi": {
    "start_local": "2027-01-15 14:13:59",
    "start_jd": 2461420.863881,
    "index": 7,
    "name": "Ashtami",
    "end_jd": 2461421.842708,
    "end_local": "2027-01-16 13:43:30"
  },
  "next_nakshatra": {
    "start_local": "2027-01-15 23:50:58",
    "start_jd": 2461421.264565,
    "index": 0,
    "name": "Ashwini",
    "end_jd": 2461422.256011,
    "end_local": "2027-01-16 23:38:39"
  },
  "next_yoga": {
    "start_local": "2027-01-15 16:17:40",
    "start_jd": 2461420.949764,
    "index": 20,
    "name": "Siddha",
    "end_jd": 2461421.880751,
    "end_local": "2027-01-16 14:38:17"
  },
  "muhurta": {
    "rahu_kaal": {
      "start_jd": 2461420.737208,
      "end_jd": 2461420.792024,
      "start_local": "2027-01-15 11:11:35",
      "end_local": "2027-01-15 12:30:31"
    },
    "yamaganda": {
      "start_jd": 2461420.901655,
      "end_jd": 2461420.95647,
      "start_local": "2027-01-15 15:08:23",
      "end_local": "2027-01-15 16:27:19"
    },
    "gulika": {
      "start_jd": 2461420.627578,
      "end_jd": 2461420.682393,
      "start_local": "2027-01-15 08:33:43",
      "end_local": "2027-01-15 09:52:39"
    },
    "abhijit": {
      "start_jd": 2461420.777406,
      "end_jd": 2461420.806641,
      "start_local": "2027-01-15 12:09:28",
      "end_local": "2027-01-15 12:51:34"
    },
    "brahma_muhurat": {
      "start_jd": 2461420.497823,
      "end_jd": 2461420.535293,
      "start_local": "2027-01-15 05:26:52",
      "end_local": "2027-01-15 06:20:49"
    }
  },
  "choghadiya": {
    "day": [
      {
        "index": 1,
        "type": "Chal",
        "is_day_ghadi": true,
        "window": {
          "start_jd": 2461420.572762,
          "end_jd": 2461420.627578,
          "start_local": "2027-01-15 07:14:47",
          "end_local": "2027-01-15 08:33:43"
        }
      },
      {
        "index": 2,
        "type": "Labh",
        "is_day_ghadi": true,
        "window": {
          "start_jd": 2461420.627578,
          "end_jd": 2461420.682393,
          "start_local": "2027-01-15 08:33:43",
          "end_local": "2027-01-15 09:52:39"
        }
      }
    ],
    "night": [
      {
        "index": 9,
        "type": "Rog",
        "is_day_ghadi": false,
        "window": {
          "start_jd": 2461421.011285,
          "end_jd": 2461421.08146,
          "start_local": "2027-01-15 17:46:15",
          "end_local": "2027-01-15 19:27:18"
        }
      },
      {
        "index": 10,
        "type": "Kaal",
        "is_day_ghadi": false,
        "window": {
          "start_jd": 2461421.08146,
          "end_jd": 2461421.151635,
          "start_local": "2027-01-15 19:27:18",
          "end_local": "2027-01-15 21:08:21"
        }
      }
    ]
  },
  "durmuhurta": [
    {
      "muhurta_index": 8,
      "window": {
        "start_jd": 2461420.777406,
        "end_jd": 2461420.806641,
        "start_local": "2027-01-15 12:09:28",
        "end_local": "2027-01-15 12:51:34"
      }
    },
    {
      "muhurta_index": 12,
      "window": {
        "start_jd": 2461420.894346,
        "end_jd": 2461420.923581,
        "start_local": "2027-01-15 14:57:51",
        "end_local": "2027-01-15 15:39:57"
      }
    }
  ],
  "varjyam": {
    "start_jd": 2461420.889678,
    "end_jd": 2461420.916943,
    "start_local": "2027-01-15 14:51:08",
    "end_local": "2027-01-15 15:30:24"
  },
  "amrit_kalam": {
    "start_jd": 2461420.310308,
    "end_jd": 2461420.337573,
    "start_local": "2027-01-15 00:56:51",
    "end_local": "2027-01-15 01:36:06"
  }
}

Field reference

Every field in the response, with its type, a real example, and what it means.

FieldTypeMeaning
date, location, tz, sunrise_jd … has_moonset, tithi, nakshatra, yoga, karana, varavarious
Every field of /v1/panchang/basic, with the same names and meanings: rise and set times, and the five elements at local sunrise with their end times.
example: "tithi": { "index": 6, "name": "Saptami", … }
sun_sign / sun_sign_indexstring / integer (0–11)
Sidereal sign of the Sun at sunrise. 0 = Aries … 11 = Pisces. Name translated when you pass `locale`.
example: "Capricorn" / 9
moon_sign / moon_sign_indexstring / integer (0–11)
Sidereal sign of the Moon at sunrise.
example: "Pisces" / 11
hindu_month.index / name / display_nameinteger (0–11) / string / string
Amanta lunar month at sunrise, as in /v1/panchang/hindu-month. 0 = Chaitra. display_name adds "Adhika " in a leap month.
example: 9 / "Pausha" / "Pausha"
hindu_month.is_adhikaboolean
true during an adhika (leap) month.
example: false
hindu_month.pakshastring
Paksha of the sunrise tithi: Shukla or Krishna.
example: "Shukla"
hindu_month.name_amanta / name_purnimantastring
Month name in both conventions. They differ in the Krishna paksha, when the purnimanta name is one month ahead.
example: "Pausha" / "Pausha"
calendar_context.ritu / ritu_histring
Season, from the Sun's sidereal sign: two signs per ritu, starting with Aries and Taurus = Vasanta.
example: "Hemanta" / "हेमंत"
calendar_context.ayana / ayana_histring
Uttarayana or Dakshinayana. Dakshinayana while the Sun is in sidereal Cancer to Sagittarius.
example: "Uttarayana" / "उत्तरायण"
calendar_context.samvat_vikram / samvat_shakainteger
Vikram Samvat and Shaka Samvat year numbers.
example: 2083 / 1948
calendar_context.samvatsara_name / samvatsara_name_histring
Name of the year in the 60-year Samvatsara cycle.
example: "Siddharthi" / "सिद्धार्थी"
Jyotish: The Brihaspati (Jupiter) samvatsara names the year in the classical Hindu calendar.
disha_shool.direction / direction_hi / remedystring
Direction to avoid when travelling on this weekday, and the classical remedy.
example: "West" / "पश्चिम" / "Eat curd (dahi) before traveling"
Jyotish: Sunday West, Monday East, Tuesday North, Wednesday North, Thursday South, Friday West, Saturday East.
nak_shool.direction / remedystring
Direction to avoid based on the nakshatra at sunrise — separate from the weekday-based Disha Shool. "none" and an empty remedy when the nakshatra has no restriction, as here.
example: "none" / ""
moon_nivas.directionstring
Direction of the Moon's dwelling, from its sign at sunrise. The API uses blocks of three signs: Aries–Gemini East, Cancer–Virgo North, Libra–Sagittarius West, Capricorn–Pisces South.
example: "South"
tithi_meta.deity / tithi_meta.typestring
Presiding deity and type of the sunrise tithi. Type is one of Nanda, Bhadra, Jaya, Rikta, Purna.
example: "Surya" / "Bhadra"
Jyotish: Tithi type sets general auspiciousness. Nanda and Purna are generally favourable; Rikta (4th, 9th, 14th) is avoided for new ventures.
nakshatra_meta.ruling_planet / deity / ganastring
Lord, deity and gana of the sunrise nakshatra. Gana is Deva, Manushya or Rakshasa.
example: "Mercury" / "Pushan" / "Deva"
Jyotish: Gana is used in matchmaking (Gana koota) and in general muhurta checks.
panchang_yogasarray
Special auspicious yogas active at sunrise. `name` is one of Amrit Siddhi, Siddha, Maitra, Sarvartha Siddhi; `trigger` names the nakshatra or tithi that formed it. Empty array when there are none.
example: [{ "name": "Amrit Siddhi", "vara": "Friday", "trigger": "Revati nakshatra" }, …]
Jyotish: Amrit Siddhi, Maitra and Sarvartha Siddhi are weekday + nakshatra combinations; Siddha here is a weekday + tithi combination.
next_tithi / next_nakshatra / next_yogaobject | omitted
The element that follows the sunrise one, with start_jd, start_local, index, name, end_jd and end_local. Present only when the sunrise element ends before the next sunrise.
example: { "start_local": "2027-01-15 14:13:59", "index": 7, "name": "Ashtami", "end_local": "2027-01-16 13:43:30", … }
Jyotish: A classical panchang lists every tithi and nakshatra that occurs between one sunrise and the next. These fields give the second one.
muhurta.rahu_kaal / yamaganda / gulika / abhijit / brahma_muhuratobject
Five muhurta windows, each with start_jd, end_jd (Julian Day, UT) and start_local, end_local. On Wednesday there is no Abhijit, and `abhijit` has start equal to end (both at sunrise).
example: { "start_local": "2027-01-15 11:11:35", "end_local": "2027-01-15 12:30:31", … }
choghadiya.day / choghadiya.nightarray (8 each)
The 16 Choghadiya slots, as in /v1/panchang/choghadiya: index 1–8 for day, 9–16 for night. Here `type` is always in English.
example: [{ "index": 1, "type": "Chal", "is_day_ghadi": true, "window": { … } }, …]
durmuhurtaarray
Durmuhurta windows of the day, as in /v1/panchang/durmuhurta.
example: [{ "muhurta_index": 8, "window": { … } }, …]
varjyam / amrit_kalamobject
Varjyam and Amrit Kalam of the sunrise nakshatra, with start_jd, end_jd, start_local and end_local. They can fall outside the sunrise-to-sunrise day; here amrit_kalam (00:56–01:36) is before sunrise.
example: { "start_local": "2027-01-15 14:51:08", "end_local": "2027-01-15 15:30:24", … }

Usage tips

How to use it

  • Panchang and Choghadiya together
    Elements, Choghadiya and every muhurta window arrive in one response, so a full panchang page needs one request (plus /v1/panchang/hora if you show horas).
  • For muhurta apps
    This is the single call for any app that shows muhurta quality for a day: Rahu Kaal, Yamaganda, Gulika, Abhijit, Brahma Muhurat, 16 Choghadiya slots, Durmuhurta, Varjyam, Amrit Kalam and Disha Shool all at once.
  • For calendar apps
    Use `calendar_context` to display the Samvat year, season (ritu) and ayana (Uttarayana/Dakshinayana), and `hindu_month` for the month name, without separate calls.
  • Check panchang_yogas
    When `panchang_yogas` is non-empty, highlight the day as especially auspicious in your UI.
  • Abhijit on Wednesday
    On Wednesday `muhurta.abhijit` has start equal to end. Treat a zero-length window as "no Abhijit today".

Errors

Every error follows the same envelope. Use the error.code field (not the message) for conditional logic in your integration.

401 Unauthorized

{
  "error": {
    "code": "unauthorized",
    "message": "missing or invalid API key",
    "request_id": "req_01hqy7k8c3e7m1n"
  }
}

402 Payment Required

{
  "error": {
    "code": "trial_exhausted",
    "message": "your free trial credits are exhausted — pick a plan to continue",
    "top_up_url": "https://lifeastroapi.com/pricing",
    "request_id": "req_01hqy7k8c3e7m1n"
  }
}

429 Too Many Requests

{
  "error": {
    "code": "rate_limited",
    "message": "rate limit exceeded; retry after 12 seconds",
    "request_id": "req_01hqy7k8c3e7m1n"
  }
}

Try it

Get a dv_live_* key from your dashboard and paste into the cURL snippet above. New accounts get 1,500 free credits. Sign up.