Panchang API reference
Updated
The panchang (Hindu calendar) endpoints of API for Astrology (apiforastrology.com) cover a day, a month or a birth moment. The daily panchang needs only a date and a place. You get the five parts of the day (tithi, nakshatra, yoga, karana and weekday) with the times they change. The group has 4 endpoints.
For today's panchang at a place, call GET /v1/panchang/daily. It also gives sunrise, sunset, rahu kaal and the choghadiya. Rahu kaal moves with the place, as why rahu kaal changes by city shows. So always send your own place. Without one, the GET endpoints use Ujjain, India. For a month calendar with festivals and fasts, use GET /v1/panchang/month. POST /v1/panchang reads the birth moment. GET /v1/tara gives a daily rating (tara bala) from a person's birth star.
The panchang is the Hindu calendar's way of describing a day. It uses five elements: the lunar day, the Moon's nakshatra (one of 27 lunar mansions), yoga, karana and weekday. /v1/panchang reads them at a birth moment. /v1/panchang/daily and /v1/panchang/month need only a date and a place, and include the times each element changes.
4 endpoints. Paths are relative to https://apiforastrology.com/api/astrology. Send your API key in the Authorization: Bearer header (see authentication). No key yet? Get a key. To send test requests from the browser, open the interactive reference.
Overview: Panchang and muhurat, Hindu calendar and festivals.
Which panchang endpoint to call
| What you need | Endpoint | Cost |
|---|---|---|
| The panchang at the moment of birth | POST /v1/panchang | 1 call |
| Today's panchang for a place, with no birth details. Start here | GET /v1/panchang/daily | 1 call |
| A daily rating (tara bala) from a person's birth star | GET /v1/tara | 1 call |
| A month calendar, one row per day, with festivals and fasts | GET /v1/panchang/month | 1 call |
Panchang at the birth moment
POST /v1/panchang
Returns the panchang for the birth moment. The panchang is the Hindu calendar's way of describing a moment. It uses five elements: tithi (the lunar day) and nakshatra (the Moon's lunar mansion, one of 27). Then yoga (one of 27 combinations of the Sun's and Moon's positions), karana (half of a lunar day) and vara (the weekday). The nakshatra comes with its ruling planet and pada (quarter).
In the Vedic calendar a day runs from sunrise to sunrise. So a birth before sunrise belongs to the previous weekday. vara is the ordinary calendar weekday and vedic_vara is the sunrise-to-sunrise one. Both are returned.
For a date and place without a birth, use /v1/panchang/daily.
Cost: Each successful request counts as 1 call toward your monthly calls.
Required inputs
| Name | In | What it is |
|---|---|---|
| year | body | Year of birth, from 1850 to 2149 (the range the planetary data covers). |
| month | body | Month of birth, from 1 (January) to 12 (December). |
| day | body | Day of the month, from 1 to 31. |
| latitude | body | Latitude of the birth place in degrees, negative for south. Text in a local number format, such as "40,7128", is also accepted. |
| longitude | body | Longitude of the birth place in degrees east of Greenwich, negative for west, so places in the Americas are negative. Text in a local number format is also accepted. |
| timezone | body | Time zone of the birth place. Either an IANA time zone name, such as America/New_York, America/Chicago or Europe/London. Or a fixed offset from UTC in hours, such as -5 or 5.5. |
Optional inputs (7), with their defaults
| Name | In | What it does |
|---|---|---|
| lang | query | Language for the names in the response, such as planets, signs, nakshatras (lunar mansions), tithis (lunar days), months and festivals. The default is en (English); GET /v1/meta lists the others. Each translated value comes with its English original in a matching <field>_en field; use the English value as a key in your code. Codes (such as result or kaal) and object keys always stay in English. Any name not yet translated stays in English and is listed in localization.untranslated. |
| hour | body | Hour of birth on the local clock at the birth place, from 0 to 23 (24-hour clock). Default 0. |
| minute | body | Minute of birth, from 0 to 59. Default 0. |
| second | body | Second of birth, from 0 to 59. Default 0. |
| timezone_fold | body | Only needed for a local time that happens twice, on the night the clocks go back. In the US since 2007, that is 1:00 to 1:59 AM on the first Sunday in November. 0 picks the first occurrence (before the change) and 1 the second. Without it, such a time is rejected, not guessed. A wrong guess would quietly move the chart by an hour. A local time that never happens, because the clocks jumped forward over it, is also rejected; check the birth time, or send the UTC offset that was in force. |
| ayanamsa | body | The ayanamsa: the offset between the tropical zodiac (used in Western astrology) and the sidereal zodiac (used in Vedic astrology). lahiri (the default) is the Lahiri, or Chitrapaksha, ayanamsa used by the Government of India. kp is the Krishnamurti ayanamsa used in KP astrology, about 6 arcminutes less. raman is B. V. Raman's, about 1 degree 27 arcminutes less. Also: yukteshwar (Sri Yukteshwar's, about 1 degree 23 arcminutes less), jn_bhasin (J. N. Bhasin's, about 1 degree 6 arcminutes less), ushashashi (about 3 degrees 48 arcminutes less) and fagan_bradley (the Western sidereal zodiac, about 53 arcminutes more). true_chitra keeps the star Spica (Chitra) at exactly 180 degrees, so it follows the star itself; it is within about a minute of arc of Lahiri. The chosen ayanamsa is also used for the transits, sade sati and forecasts read against this chart. |
| node | body | How to calculate Rahu and Ketu, the lunar nodes (the two points where the Moon's orbit crosses the Sun's path). Use true for the actual position (the default) or mean for the averaged position. |
Main response fields
tithi(object): holds index, name, paksha, completion_percent.yoga(object): holds index, name, completion_percent.karana(object): holds index, name, completion_percent.vara(object): holds index, name, lord.vedic_vara(object): holds index, name, lord, before_sunrise.note(string)nakshatra(object): holds name, lord, pada.meta(object): holds ayanamsa, ayanamsa_value, julian_day, ephemeris, node, timezone.
# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/panchang" \
-H "Authorization: Bearer $ASTROLOGY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"year":1990,"month":8,"day":15,"hour":10,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'{
"tithi": {
"index": 25,
"name": "Dashami",
"paksha": "krishna",
"completion_percent": 64.9975
},
"yoga": {
"index": 14,
"name": "Harshana",
"completion_percent": 0.1278
},
"karana": {
"index": 50,
"name": "Vishti",
"completion_percent": 29.9949
},
"vara": {
"index": 4,
"name": "Wednesday",
"lord": "Mercury"
},
"vedic_vara": {
"index": 4,
"name": "Wednesday",
"lord": "Mercury",
"before_sunrise": false
},
"note": "`vara` is the civil weekday; `vedic_vara` runs sunrise to sunrise and is what the vara lord is read from",
"nakshatra": {
"name": "Mrigashira",
"lord": "Mars",
"pada": 1
},
"meta": {
"ayanamsa": "lahiri",
"ayanamsa_value": 23.7260727,
"julian_day": 2448119.10483,
"ephemeris": "JPL DE440s",
"node": "true",
"timezone": {
"source": "zone",
"offset_hours": -4,
"zone": "America/New_York",
"abbreviation": "EDT",
"dst": true,
"dst_hours": 1,
"ambiguous_resolved_by_fold": null,
"note": "read from the IANA tz database at this instant, so daylight saving and historical offset changes are included"
}
}
}Example from a real call for John Doe, born Aug 15, 1990, 10:30 AM, New York. Long lists and texts are shortened.
Parameters, schemas and a test request in the interactive reference. Feature: Panchang and muhurat.
Daily panchang for a date and place, no birth data
GET /v1/panchang/daily
Returns the panchang for a date and place. No birth data is needed.
The panchang is the Hindu calendar's way of describing a day. It uses five elements: tithi (the lunar day) and nakshatra (the Moon's lunar mansion, one of 27). Then yoga (a combination of the Sun's and Moon's positions), karana (half of a lunar day) and vara (the weekday). The response also has sunrise and sunset, moonrise and moonset, the lunar month, the season and the era years. It also has daily periods such as rahu kaal (a period avoided for new starts), choghadiya and hora (traditional divisions of the day).
The lunar month is named both ways: masa.amanta (Maharashtra, Gujarat and South India, where a month ends at the new moon) and masa.purnimanta (North India, where it ends at the full moon). They differ only in a month's waning half. calendar chooses which goes in masa.name; without it, amanta. samvat.vikram_kartikadi is the Vikram year as Gujarat counts it, from the day after Diwali.
The day is read at sunrise, as the Hindu calendar does. The tithi of a date is the one running when the Sun rises, not at midnight. Each element has a start and end time, because most of them change during the day.
changes lists every change of tithi, nakshatra, yoga and karana from this sunrise to the next. bands lists the parts of the day and special periods. These are pradosh (around sunset), nishita (around midnight), dur muhurta (periods to avoid) and brahma muhurta (before dawn). They also include bhadra (the time of the Vishti karana, avoided for new starts). The last is panchaka (when the Moon is in Kumbha or Meena, the signs Aquarius and Pisces). The muhurta and festival endpoints use these same periods. So they always agree with this endpoint about, for example, when bhadra ended. Varjyam and amrit kaal are not calculated yet; they are listed in bands.not_computed until their table is verified.
good_for says what kinds of activity the day suits. It is not a muhurta (a chosen good time for one activity).
day_yogas lists the day's yogas made from the weekday and the Moon's nakshatra, each with its start and end. anandadi is the Anandadi yoga (one of 28, counted with Abhijit as a 28th nakshatra), marked auspicious or inauspicious. It changes when the nakshatra changes. special_yogas covers Sarvartha Siddhi, Amrit Siddhi, Visha, Dwipushkar, Tripushkar, Ravi Yoga, Guru Pushya and Ravi Pushya. Each has forms_today and its spans, so an empty list means "not today", not "not checked". While Amrit Siddhi runs with its cancelling tithi it is Visha yoga (inauspicious) instead: those spans say was and cancelled_by, and sources_agree: false because some calendars list them as Amrit Siddhi. disha_shool carries three INDEPENDENT directions to avoid starting a trip toward, never merged into one: direction from the weekday, tithi_shool.spans from the running lunar day (always holds – every tithi maps to one of eight directions) and nakshatra_shool.spans from the Moon's star (only four of 27 forbid a direction, so most days hold none). chandrashtama lists all 12 Moon signs and, for each, when today the Moon is in the 8th sign from it. Every span is cut to this sunrise and the next one. Each name carries a short reading.
Every parameter is optional. With none, the answer is for today in Ujjain, India, so GET /v1/panchang/daily works on its own. For any other place, send latitude, longitude and timezone together.
Cost: Each successful request counts as 1 call toward your monthly calls.
Required inputs
None.
Optional inputs (7), with their defaults
| Name | In | What it does |
|---|---|---|
| lang | query | Language of the reading text, such as en (English, the default) or hi (Hindi). GET /v1/meta lists the languages available. If a passage is not written in that language yet, the English passage is returned instead and marked with fell_back_to_en. Names in the response, such as planets and signs, are translated too. |
| detail | query | Length of the reading text: standard (the default) or expanded, which is about 1.8 times longer. If a passage has no expanded version yet, the standard one is returned. Each text block reports the length it got in its detail field. |
| date | query | Calendar date, YYYY-MM-DD. Defaults to today in the requested time zone. |
| latitude | query | Latitude in degrees, negative for south. Defaults to Ujjain, India, the traditional reference place for the Hindu calendar. |
| longitude | query | Longitude in degrees, negative for west. Defaults to Ujjain, India. |
| timezone | query | IANA time zone name such as America/New_York, or a fixed offset from UTC in hours such as -5. A zone name gets the daylight saving time rule for that date. Defaults to 5.5 (India time), so send it whenever you send your own latitude and longitude. |
| calendar | query | How to name the lunar months: amanta or purnimanta. In amanta calendars (Maharashtra, Gujarat and South India) a month ends at the new moon. In purnimanta calendars (North India) it ends at the full moon. Only the name of the month in its waning half differs. Dates never change. Both names are always in the response (amanta and purnimanta), and this setting chooses which one goes in name. Other languages keep this endpoint's usual one. convention says which was used. |
Main response fields
date(string)place(object): holds latitude, longitude, timezone, timezone_info.sun(object): holds rise, set.moon(object): holds rise, set.tithi(object): holds index, name, paksha, completion_percent, starts, ends.nakshatra(object): holds name, lord, pada, starts, ends.yoga(object): holds index, name, completion_percent, starts, ends.karana(object): holds index, name, completion_percent, starts, ends.vara(object): holds index, name, lord.masa(object): holds name, paksha, adhika, kshaya, convention, starts, ends, amanta, purnimanta, rule.ritu(object): holds name, season.ritu_lunar(object): holds name, season.samvat(object): holds shaka, vikram, vikram_kartikadi, note.ayana(string)ayana_sidereal(string)reckoning(object): holds ritu, ayana, ritu_lunar, ayana_sidereal, note.inauspicious(object): holds rahu_kaal, yamaganda, gulika_kaal.auspicious(object): holds abhijit_muhurta.muhurta(object): holds weekday_lord, conflicts, choghadiya, hora, rule, note, readings, gaps, language, detail.reckoned_at(string)meta(object): holds ayanamsa, ayanamsa_value, ephemeris.changes(object): holds tithi, karana, yoga, nakshatra.bands(object): holds day_parts, pradosh, nishita, dur_muhurta, brahma_muhurta, bhadra, panchaka, rule, not_computed.day_yogas(object): holds weekday, anandadi, special_yogas, rule, not_computed, readings, gaps.disha_shool(object): holds weekday, direction, rule, tithi_shool, nakshatra_shool, reading.chandrashtama(object): holds by_moon_sign, rule, reading.good_for(object): holds reckoned_at, limbs, gaps, not_a_muhurta.
# New York, Oct 1, 2026
curl "https://apiforastrology.com/api/astrology/v1/panchang/daily?date=2026-10-01&latitude=40.7128&longitude=-74.006&timezone=America/New_York" \
-H "Authorization: Bearer $ASTROLOGY_API_KEY"{
"date": "2026-10-01",
"place": {
"latitude": 40.7128,
"longitude": -74.006,
"timezone": -4,
"timezone_info": {
"source": "zone",
"offset_hours": -4,
"zone": "America/New_York",
"abbreviation": "EDT",
"dst": true,
"dst_hours": 1,
"ambiguous_resolved_by_fold": null,
"note": "read from the IANA tz database at this instant, so daylight saving and historical offset changes are included"
}
},
"sun": {
"rise": "2026-10-01T06:52:37-04:00",
"set": "2026-10-01T18:37:57-04:00"
},
"moon": {
"rise": "2026-10-01T21:38:37-04:00",
"set": "2026-10-01T12:44:56-04:00"
},
"tithi": {
"index": 21,
"name": "Shashthi",
"paksha": "krishna",
"completion_percent": 17.4653,
"starts": "2026-10-01T03:05:43-04:00",
"ends": "2026-10-02T00:45:43-04:00"
},
"nakshatra": {
"name": "Rohini",
"lord": "Moon",
"pada": 2,
"starts": "2026-09-30T20:32:55-04:00",
"ends": "2026-10-01T18:57:24-04:00"
},
"yoga": {
"index": 16,
"name": "Siddhi",
"completion_percent": 76.4854,
"starts": "2026-09-30T14:50:35-04:00",
"ends": "2026-10-01T11:48:23-04:00"
},
"karana": {
"index": 41,
"name": "Gara",
"completion_percent": 34.9307,
"starts": "2026-10-01T03:05:43-04:00",
"ends": "2026-10-01T13:55:24-04:00"
},
"vara": {
"index": 5,
"name": "Thursday",
"lord": "Jupiter"
},
"masa": {
"name": "Bhadrapada",
"paksha": "krishna",
"adhika": false,
"kshaya": false,
"convention": "amanta",
"starts": "2026-09-10T23:27:00-04:00",
"ends": "2026-10-10T11:50:05-04:00",
"amanta": {
"name": "Bhadrapada",
"adhika": false
},
"purnimanta": {
"name": "Asvina",
"adhika": false
},
"rule": "a lunar month runs new moon to new moon and is named after the sankranti it contains; none makes it adhika, two make it kshaya. Purnimanta names the dark half after the following month; a leap month keeps its bounds in both"
},
"ritu": {
"name": "Sharad",
"season": "autumn"
},
"ritu_lunar": {
"name": "Varsha",
"season": "monsoon"
},
"samvat": {
"shaka": 1948,
"vikram": 2083,
"vikram_kartikadi": 2082,
"note": "shaka and vikram turn at Chaitra, not at the Gregorian new year; vikram_kartikadi is the Vikram year as Gujarat counts it, turning at Kartika (the day after Diwali)"
},
"ayana": "Dakshinayana",
"ayana_sidereal": "Dakshinayana",
"reckoning": {
"ritu": "tropical Sun",
"ayana": "tropical Sun",
"ritu_lunar": "lunar month",
"ayana_sidereal": "sidereal Sun",
"note": "ritu and ayana follow the solstices and equinoxes (the tropical Sun). Festivals, vrats and the lunar month keep the lunar reckoning; their dates are unchanged."
},
"inauspicious": {
"rahu_kaal": {
"starts": "2026-10-01T14:13:27-04:00",
"ends": "2026-10-01T15:41:37-04:00"
},
"yamaganda": {
"starts": "2026-10-01T06:52:37-04:00",
"ends": "2026-10-01T08:20:47-04:00"
},
"gulika_kaal": {
"starts": "2026-10-01T09:48:57-04:00",
"ends": "2026-10-01T11:17:07-04:00"
}
},
"auspicious": {
"abhijit_muhurta": {
"starts": "2026-10-01T12:21:46-04:00",
"ends": "2026-10-01T13:08:47-04:00",
"overlaps": [],
"clear": [
{
"starts": "2026-10-01T12:21:46-04:00",
"ends": "2026-10-01T13:08:47-04:00"
}
]
}
},
"muhurta": {
"weekday_lord": "Jupiter",
"conflicts": [
{
"band": "yamaganda",
"choghadiya": "Shubh",
"eighth": 1,
"note": "Shubh is reckoned benefit and auspicious beginnings, and yamaganda covers the same eighth of the day. The two tables disagree here; neither is applied over the other."
},
{
"band": "rahu_kaal",
"choghadiya": "Amrit",
"eighth": 6,
"note": "Amrit is reckoned the best of the eight, and rahu kaal covers the same eighth of the day. The two tables disagree here; neither is applied over the other."
}
],
"choghadiya": {
"day": [
{
"graha": "Jupiter",
"name": "Shubh",
"quality": "auspicious",
"signifies": "benefit and auspicious beginnings",
"starts": "2026-10-01T06:52:37-04:00",
"ends": "2026-10-01T08:20:47-04:00",
"index": 1
},
{
"graha": "Mars",
"name": "Rog",
"quality": "inauspicious",
"signifies": "illness and conflict",
"starts": "2026-10-01T08:20:47-04:00",
"ends": "2026-10-01T09:48:57-04:00",
"index": 2
},
{
"graha": "Sun",
"name": "Udveg",
"quality": "inauspicious",
"signifies": "anxiety and unrest",
"starts": "2026-10-01T09:48:57-04:00",
"ends": "2026-10-01T11:17:07-04:00",
"index": 3
}
],
"night": [
{
"graha": "Moon",
"name": "Amrit",
"quality": "auspicious",
"signifies": "the best of the eight",
"starts": "2026-10-01T18:37:57-04:00",
"ends": "2026-10-01T20:09:54-04:00",
"index": 1
},
{
"graha": "Venus",
"name": "Char",
"quality": "neutral",
"signifies": "movement; good for travel",
"starts": "2026-10-01T20:09:54-04:00",
"ends": "2026-10-01T21:41:52-04:00",
"index": 2
},
{
"graha": "Mars",
"name": "Rog",
"quality": "inauspicious",
"signifies": "illness and conflict",
"starts": "2026-10-01T21:41:52-04:00",
"ends": "2026-10-01T23:13:50-04:00",
"index": 3
}
]
},
"hora": [
{
"index": 1,
"lord": "Jupiter",
"starts": "2026-10-01T06:57:02-04:00",
"ends": "2026-10-01T07:57:04-04:00"
},
{
"index": 2,
"lord": "Mars",
"starts": "2026-10-01T07:57:04-04:00",
"ends": "2026-10-01T08:57:07-04:00"
},
{
"index": 3,
"lord": "Sun",
"starts": "2026-10-01T08:57:07-04:00",
"ends": "2026-10-01T09:57:09-04:00"
}
],
"rule": "all three walk the descending Chaldean order -- Saturn, Jupiter, Mars, Sun, Venus, Mercury, Moon. Horas and day choghadiya start at the weekday lord and move one place at a time; night choghadiya start at the lord of the fifth weekday from…",
"note": "day choghadiya divide daylight, night choghadiya divide the night, and horas divide sunrise to sunrise. The three do not share boundaries and are not meant to. Choghadiya and the bands run on the visible sunrise the calendars print; the…",
"readings": {
"choghadiya": {
"Shubh": {
"text": [
"Shubh, which means auspicious, is the right window for proper, formal beginnings. The day is divided into eight choghadiyas, blocks of about an hour and a half, and so is the night. Each one is ruled by a planet. Shubh belongs to Jupiter,…",
"Use it to sign contracts, go to important appointments or open a business. It also suits a ceremony connected with study or worship."
],
"language": "en",
"detail": "standard"
},
"Rog": {
"text": [
"Rog means illness or conflict. The day and the night each run through eight choghadiyas, blocks of about an hour and a half. Each block takes the character of its planet, and Rog belongs to Mars, the planet of force and conflict. Classical…",
"Keep it for hard physical work, a tough workout, a sports match, or settling a pressing dispute that needs courage."
],
"language": "en",
"detail": "standard"
},
"Udveg": {
"text": [
"Udveg means unease. The day and the night are each split into eight choghadiyas, blocks of about an hour and a half. Each one carries the nature of its planet, and Udveg belongs to the Sun. Its energy is tense and restless, so something…",
"Avoid starting a sensitive personal conversation, taking a loan, or taking a gamble in this window. Use it instead for your regular routine or for quiet reflection, and save new starts for the next good block."
],
"language": "en",
"detail": "standard"
},
"Char": {
"text": [
"Char is a neutral to mildly good window for movement and change. Each day and each night holds eight choghadiyas, blocks of roughly an hour and a half. A planet is in charge of each. Char belongs to Venus, and the word means moving. So it…",
"Char is not the best time for ceremonies meant to stay fixed for good: things begun in it keep moving. It helps most when you need to stay flexible, take a trip or make a change for the better."
],
"language": "en",
"detail": "standard"
},
"Labh": {
"text": [
"Labh means gain or profit. The day and night are cut into eight choghadiyas each, blocks of about an hour and a half. Each block takes the mood of its planet, and Labh belongs to Mercury, the planet of trade and quick thinking. So it helps…",
"Use it when you want a better return on business or need to close a deal. It also suits sending in an application. It can give you an edge in how you put your case."
],
"language": "en",
"detail": "standard"
},
"Amrit": {
"text": [
"Amrit, which means nectar, is seen as the best of all the choghadiyas. The day and the night are each divided into eight choghadiyas, blocks of roughly an hour and a half. Each block belongs to a planet, and Amrit belongs to the Moon.…",
"So Amrit is your best window for medical treatment, a religious celebration or setting out on an important trip. It also suits holding a family ceremony that matters to you. If you can move only one thing in your day, move it here."
],
"language": "en",
"detail": "standard"
},
"Kaal": {
"text": [
"The word Kaal is linked with time and loss. Every day and every night is split into eight choghadiyas, each about an hour and a half long. Each one is ruled by a planet, and Kaal belongs to Saturn, the planet of delay. Its energy is heavy…",
"Put off celebrations and good beginnings during this time. Use it instead for clearing out, routine upkeep, dealing with debts and some quiet thinking."
],
"language": "en",
"detail": "standard"
}
},
"hora": {
"Jupiter": {
"text": [
"Hora means a planetary hour: from sunrise, the seven planets take turns ruling one hour each. Jupiter is the planet of teachers, wisdom and good fortune. So its hora is the best of the seven for beginnings that need a blessing. That covers…",
"You meet a Jupiter hora three or four times a day. When it falls in a Shubh choghadiya, you have the same planet twice over. If a full muhurta (a carefully chosen time) can't be worked out, use that overlap for a formal beginning. That is…"
],
"language": "en",
"detail": "standard"
},
"Mars": {
"text": [
"Each hour from sunrise onward is a hora, a planetary hour ruled in turn by one of the seven planets. Mars is the planet of force, courage and conflict, so its hora is good for things that need force. These include surgery, physical work, a…",
"A Mars hora turns up three or four times in every 24 hours. When it falls inside a Rog choghadiya, which also belongs to Mars, the two point strongly the same way. That stretch is worth avoiding for anything likely to cause an argument.…"
],
"language": "en",
"detail": "standard"
},
"Sun": {
"text": [
"The Sun's hora is good for dealing with people above you. A hora is a planetary hour. Counting from sunrise, each hour of the day and night belongs to one of the seven planets in turn. Each hour takes on its planet's nature, and the Sun…",
"Each hora lasts about an hour. Every planet's hora comes around three or four times between one sunrise and the next. So waiting for the right one rarely costs you a whole day. Because the count runs from sunrise to sunrise, not midnight…"
],
"language": "en",
"detail": "standard"
},
"Venus": {
"text": [
"A hora is one planet's hour: counted from sunrise, the seven planets rule the hours in a repeating order. Venus is the planet of love, beauty and comfort. So its hora is good for marriage, relationships, art and buying things meant to give…",
"It comes around three or four times a day. A Char choghadiya also belongs to Venus. When the two overlap, the pair is traditionally read as good for travel. That is because in this scheme Venus rules movement. When a Venus hora falls in…"
],
"language": "en",
"detail": "standard"
},
"Mercury": {
"text": [
"From sunrise, the hours of the day and night are handed out one by one to the seven planets. Each such hour is called a hora. Mercury is the planet of speech, trade and quick thinking. So its hora is good for every kind of communication:…",
"It comes around three or four times a day, so one is nearly always within reach. When a Mercury hora falls inside a Labh choghadiya, that is the classic slot for trade. Both belong to Mercury, and the overlap happens on most days."
],
"language": "en",
"detail": "standard"
},
"Moon": {
"text": [
"The horas are planetary hours: starting at sunrise, each hour belongs to one of the seven planets in a fixed order. The Moon rules the mind, the mother and water. So its hora is good for anything to do with the home, your mother, water and…",
"A Moon hora comes around three or four times in 24 hours. So one is usually only a few hours away. Where it overlaps with an Amrit choghadiya, use them together. Both belong to the Moon, so they strengthen each other rather than just…"
],
"language": "en",
"detail": "standard"
},
"Saturn": {
"text": [
"The day is counted in horas: planetary hours that start at sunrise and pass from one of the seven planets to the next. Saturn is the planet of time, effort and delay. So its hora is good for work that is slow, solid and unglamorous. That…",
"Saturn's hora recurs three or four times between sunrises. For a beginning, it is the one hora worth actively avoiding. When it falls in a Kaal choghadiya, both belong to Saturn and the warning is doubled. For finishing something, though,…"
],
"language": "en",
"detail": "standard"
}
}
},
"gaps": [],
"language": "en",
"detail": "standard"
},
"reckoned_at": "sunrise",
"meta": {
"ayanamsa": "lahiri",
"ayanamsa_value": 24.230763,
"ephemeris": "JPL DE440s"
},
"changes": {
"tithi": [
{
"index": 21,
"name": "Shashthi",
"paksha": "krishna",
"starts": "2026-10-01T03:05:43-04:00",
"ends": "2026-10-02T00:45:43-04:00",
"class": "nanda"
},
{
"index": 22,
"name": "Saptami",
"paksha": "krishna",
"starts": "2026-10-02T00:45:43-04:00",
"ends": "2026-10-02T22:30:08-04:00",
"class": "bhadra"
}
],
"karana": [
{
"index": 41,
"name": "Gara",
"starts": "2026-10-01T03:05:43-04:00",
"ends": "2026-10-01T13:55:24-04:00",
"class": "movable"
},
{
"index": 42,
"name": "Vanija",
"starts": "2026-10-01T13:55:24-04:00",
"ends": "2026-10-02T00:45:43-04:00",
"class": "movable"
},
{
"index": 43,
"name": "Vishti",
"starts": "2026-10-02T00:45:43-04:00",
"ends": "2026-10-02T11:37:09-04:00",
"class": "vishti"
}
],
"yoga": [
{
"index": 16,
"name": "Siddhi",
"starts": "2026-09-30T14:50:35-04:00",
"ends": "2026-10-01T11:48:23-04:00",
"class": "favorable"
},
{
"index": 17,
"name": "Vyatipata",
"starts": "2026-10-01T11:48:23-04:00",
"ends": "2026-10-02T08:47:43-04:00",
"class": "unfavorable"
}
],
"nakshatra": [
{
"index": 4,
"name": "Rohini",
"lord": "Moon",
"starts": "2026-09-30T20:32:55-04:00",
"ends": "2026-10-01T18:57:24-04:00",
"class": "dhruva"
},
{
"index": 5,
"name": "Mrigashira",
"lord": "Mars",
"starts": "2026-10-01T18:57:24-04:00",
"ends": "2026-10-02T17:25:13-04:00",
"class": "mridu"
}
]
},
"bands": {
"day_parts": {
"pratah": {
"starts": "2026-10-01T06:52:37-04:00",
"ends": "2026-10-01T09:13:41-04:00"
},
"sangava": {
"starts": "2026-10-01T09:13:41-04:00",
"ends": "2026-10-01T11:34:45-04:00"
},
"madhyahna": {
"starts": "2026-10-01T11:34:45-04:00",
"ends": "2026-10-01T13:55:49-04:00"
},
"aparahna": {
"starts": "2026-10-01T13:55:49-04:00",
"ends": "2026-10-01T16:16:53-04:00"
},
"sayahna": {
"starts": "2026-10-01T16:16:53-04:00",
"ends": "2026-10-01T18:37:57-04:00"
}
},
"pradosh": {
"starts": "2026-10-01T18:37:57-04:00",
"ends": "2026-10-01T21:05:05-04:00"
},
"nishita": {
"starts": "2026-10-02T00:21:16-04:00",
"ends": "2026-10-02T01:10:19-04:00"
},
"dur_muhurta": [
{
"starts": "2026-10-01T10:47:44-04:00",
"ends": "2026-10-01T11:34:45-04:00",
"muhurta": 6,
"half": "day"
},
{
"starts": "2026-10-01T15:29:51-04:00",
"ends": "2026-10-01T16:16:53-04:00",
"muhurta": 12,
"half": "day"
}
],
"brahma_muhurta": {
"starts": "2026-10-01T05:14:53-04:00",
"ends": "2026-10-01T06:03:45-04:00"
},
"bhadra": [
{
"starts": "2026-10-02T00:45:43-04:00",
"ends": "2026-10-02T11:37:09-04:00"
}
],
"panchaka": [],
"rule": "daylight and night are each fifteen equal muhurtas. The day parts are groups of three; pradosh is the night's first three, nishita its eighth. Dur muhurta by weekday. Bhadra is the Vishti karana; panchaka is the Moon in Kumbha or Meena.…",
"not_computed": {
"varjyam": "read from a 27-row table of ghati offsets per nakshatra; not reproduced until the table is verified against a source",
"amrit_kaal": "same table family as varjyam; same reason",
"godhuli": "sources give different spans around sunset"
}
},
"day_yogas": {
"weekday": "Thursday",
"anandadi": [
{
"starts": "2026-10-01T06:52:37-04:00",
"ends": "2026-10-01T18:57:24-04:00",
"name": "Utpata",
"number": 16,
"nature": "inauspicious",
"nakshatra": "Rohini"
},
{
"starts": "2026-10-01T18:57:24-04:00",
"ends": "2026-10-02T06:53:38-04:00",
"name": "Mrityu",
"number": 17,
"nature": "inauspicious",
"nakshatra": "Mrigashira"
}
],
"special_yogas": [
{
"code": "sarvartha_siddhi",
"name": "Sarvartha Siddhi",
"nature": "auspicious",
"forms_today": false,
"spans": [],
"rule": "the weekday with one of its listed nakshatras. Tithi is not judged here"
},
{
"code": "amrit_siddhi",
"name": "Amrit Siddhi",
"nature": "auspicious",
"forms_today": false,
"spans": [],
"rule": "the weekday with its one nakshatra. While one tithi per weekday runs with it, the yoga turns into Visha yoga: those minutes are listed under `visha`, not here"
},
{
"code": "visha",
"name": "Visha",
"nature": "inauspicious",
"forms_today": false,
"spans": [],
"rule": "Amrit Siddhi running with its cancelling tithi (Muhurta Chintamani). Each span names what it replaced (`was`) and why (`cancelled_by`). The published calendar we check against does not apply the cancellation and lists these minutes as…"
}
],
"rule": "Anandadi: count the Moon's nakshatra from the weekday's starting nakshatra (Sunday Ashwini, Monday Mrigashira, Tuesday Ashlesha, Wednesday Hasta, Thursday Anuradha, Friday Uttara Ashadha, Saturday Shatabhisha) over 28 nakshatras with…",
"not_computed": {
"tithi_cancellations": "Sarvartha Siddhi tithi exceptions differ by source and are not applied"
},
"readings": {
"anandadi": {
"Utpata": {
"text": [
"Utpata is one of the 28 Anandadi yogas. Each one is a mood of the day, read from the weekday and the Moon's nakshatra (star). Utpata means upset. Plans may get stirred up. Avoid new starts and keep to what is already in hand."
],
"language": "en",
"detail": "standard"
},
"Mrityu": {
"text": [
"Mrityu is one of the 28 Anandadi yogas. Each one is a mood of the day, read from the weekday and the Moon's nakshatra (star). Mrityu has a heavy old name. Read it simply as a time to avoid new starts and travel. Routine work is fine."
],
"language": "en",
"detail": "standard"
}
},
"special_yogas": {
"ravi_yoga": {
"text": [
"Ravi Yoga is a good time that comes from the Sun's and the Moon's nakshatras (stars). It is said to clear many small faults of the day. It suits new work, travel and important tasks."
],
"language": "en",
"detail": "standard"
}
}
},
"gaps": []
},
"disha_shool": {
"weekday": "Thursday",
"direction": "south",
"rule": "the direction to avoid starting a journey toward on this weekday: east on Monday and Saturday, north on Tuesday and Wednesday, south on Thursday, west on Friday and Sunday. `tithi_shool` and `nakshatra_shool` report two more, independent…",
"tithi_shool": {
"spans": [
{
"starts": "2026-10-01T06:52:37-04:00",
"ends": "2026-10-02T00:45:43-04:00",
"direction": "west",
"tithi": "Shashthi"
},
{
"starts": "2026-10-02T00:45:43-04:00",
"ends": "2026-10-02T06:53:38-04:00",
"direction": "northwest",
"tithi": "Saptami"
}
],
"rule": "the direction forbidden by the running tithi, by its number within either paksha (so tithi 3 is Shukla and Krishna Tritiya alike), except Purnima (Shukla's 15th) and Amavasya (Krishna's 15th), which go to different directions. Every tithi…"
},
"nakshatra_shool": {
"spans": [
{
"starts": "2026-10-01T06:52:37-04:00",
"ends": "2026-10-01T18:57:24-04:00",
"direction": "west",
"nakshatra": "Rohini"
}
],
"rule": "the direction forbidden while the Moon transits Jyeshtha (east), Purva Bhadrapada (south), Rohini (west) or Uttara Phalguni (north). Only these four of the 27 nakshatras forbid a direction, so most days hold no span here"
},
"reading": {
"text": [
"Disha shool is the direction in which it is better not to start a journey today. It is set by the weekday. Trips in other directions are not affected."
],
"language": "en",
"detail": "standard"
}
},
"chandrashtama": {
"by_moon_sign": [
{
"moon_sign": "Aries",
"moon_sign_no": 1,
"eighth_sign": "Scorpio",
"holds_today": false,
"spans": []
},
{
"moon_sign": "Taurus",
"moon_sign_no": 2,
"eighth_sign": "Sagittarius",
"holds_today": false,
"spans": []
},
{
"moon_sign": "Gemini",
"moon_sign_no": 3,
"eighth_sign": "Capricorn",
"holds_today": false,
"spans": []
}
],
"rule": "the transit Moon in the 8th sign from a birth Moon sign, counted in whole signs. Find your own birth Moon sign in the list",
"reading": {
"text": [
"Chandrashtama is the time when the Moon passes through the 8th sign from your birth Moon sign (rashi). It comes for about two and a half days each month. It is better for rest and routine than for new starts."
],
"language": "en",
"detail": "standard"
}
},
"good_for": {
"reckoned_at": "sunrise",
"limbs": {
"tithi": {
"name": "Shashthi",
"class": "nanda",
"text": [
"The day's tithi (lunar day) is a Nanda tithi. The 30 lunar days of a month fall into five groups, and each group gives the day its own character. Nanda means joy, so it suits things you start for fun. Think of celebrations, music and…",
"Because it is a light day, it is not one for heavy undertakings. Enjoy it for what it is good at, and keep contracts and foundations for a Bhadra or Purna tithi."
],
"language": "en",
"detail": "standard"
},
"nakshatra": {
"name": "Rohini",
"class": "dhruva",
"text": [
"The nakshatra is the star group the Moon is passing through, one of 27. Each belongs to one of seven natures. Today's is fixed (dhruva), so it suits things meant to stay. Think of laying a foundation, planting, buying land or a home, or a…",
"What starts under it tends to settle and hold. That is also why it is a bad day for travel, or for anything you expect to change soon."
],
"language": "en",
"detail": "standard"
},
"yoga": {
"name": "Siddhi",
"class": "favorable",
"text": [
"The panchang (the traditional calendar) reads each day through five limbs: the tithi, the weekday, the nakshatra, the yoga and the karana. The yoga comes from the Sun's and Moon's positions added together. Today's is one of the 18 counted…",
"Of the five limbs, the yoga carries the least weight. Take it as a confirmation, not as a reason to act."
],
"language": "en",
"detail": "standard"
},
"karana": {
"name": "Gara",
"class": "movable",
"text": [
"A karana is half of a tithi (lunar day), and the current one is a movable karana other than Vishti. The movable karanas repeat through the month. Apart from Vishti, none of them puts a limit of its own on the day.",
"So the karana neither helps nor blocks your plans today. Judge the day by its tithi and nakshatra instead, and pick your time from what they support."
],
"language": "en",
"detail": "standard"
}
},
"gaps": [],
"not_a_muhurta": "what the day is suited to, from its limbs at sunrise. Choosing a time for one activity is /v1/muhurta/{activity}, which judges the weekday, month and the moment of beginning as well."
}
}Example from a real call for New York, Oct 1, 2026. Long lists and texts are shortened.
Parameters, schemas and a test request in the interactive reference. Feature: Panchang and muhurat. Free tool: Today's panchang.
Tara bala: a daily rating from a birth nakshatra, no chart
GET /v1/tara
Returns tara bala for one or more days. Tara bala is a traditional daily rating. Count from the birth nakshatra to the day's nakshatra, and take the remainder after dividing by nine. The birth nakshatra is the lunar mansion (one of 27) that the Moon was in at birth. That gives one of nine taras. The 3rd, 5th and 7th are unfavorable.
Only the birth nakshatra is needed, not a birth time. Many people know their nakshatra from a family horoscope or from their name.
The day's nakshatra is read at sunrise, the same way /v1/reading/daily reads it. So the two endpoints agree for the same nakshatra and day. The nakshatra usually changes during the day, so every change and its tara is listed too.
Each tara carries its reading: what the day tends to suit, in plain words. Takes ?lang and ?detail.
Cost: Each successful request counts as 1 call toward your monthly calls.
Required inputs
| Name | In | What it is |
|---|---|---|
| nakshatra | query | Birth nakshatra (lunar mansion): its name in any common spelling, or its number from 1 to 27. |
Optional inputs (7), with their defaults
| Name | In | What it does |
|---|---|---|
| date | query | Calendar date, YYYY-MM-DD. Defaults to today in the requested time zone. |
| latitude | query | Latitude in degrees, negative for south. Defaults to Ujjain, India. |
| longitude | query | Longitude in degrees, negative for west. Defaults to Ujjain, India. |
| timezone | query | IANA time zone name such as America/New_York, or a fixed offset from UTC in hours such as -5. Defaults to 5.5 (India time). |
| days | query | How many days to return, starting with date. From 1 to 31. |
| lang | query | Language of the reading text, such as en (English, the default) or hi (Hindi). GET /v1/meta lists the languages available. If a passage is not written in that language yet, the English passage is returned instead and marked with fell_back_to_en. Names in the response, such as planets and signs, are translated too. |
| detail | query | Length of the reading text: standard (the default) or expanded, which is about 1.8 times longer. If a passage has no expanded version yet, the standard one is returned. Each text block reports the length it got in its detail field. |
Main response fields
birth_nakshatra(object): holds nakshatra, nakshatra_lord, number.place(object): holds latitude, longitude, timezone, timezone_info.days(array of objects): each item holds date, sunrise, at_sunrise, during_the_day.rule(string)
# New York, Oct 1, 2026
curl "https://apiforastrology.com/api/astrology/v1/tara?nakshatra=Mrigashira&date=2026-10-01&latitude=40.7128&longitude=-74.006&timezone=America/New_York" \
-H "Authorization: Bearer $ASTROLOGY_API_KEY"{
"birth_nakshatra": {
"nakshatra": "Mrigashira",
"nakshatra_lord": "Mars",
"number": 5
},
"place": {
"latitude": 40.7128,
"longitude": -74.006,
"timezone": -4,
"timezone_info": {
"source": "zone",
"offset_hours": -4,
"zone": "America/New_York",
"abbreviation": "EDT",
"dst": true,
"dst_hours": 1,
"ambiguous_resolved_by_fold": null,
"note": "read from the IANA tz database at this instant, so daylight saving and historical offset changes are included"
}
},
"days": [
{
"date": "2026-10-01",
"sunrise": "2026-10-01T06:52:37-04:00",
"at_sunrise": {
"nakshatra": "Rohini",
"starts": "2026-09-30T20:32:55-04:00",
"ends": "2026-10-01T18:57:24-04:00",
"tara": 9,
"name": "Ati-Mitra",
"count_name": "Ati-Mitra",
"auspicious": true,
"severity": null,
"severity_reason": null,
"signifies": "the most favorable; support arrives without asking",
"reading": {
"text": [
"**Today is the most helpful step in your cycle of nine.** Count from your birth star, the nakshatra (star group) the Moon was in when you were born, to today's star. Today lands on the step of the great friend. Help tends to come without…",
"What you can do: use the day for something that matters to you. Make an important request or start a task you have planned. Still check the details before you commit."
],
"language": "en",
"detail": "standard"
}
},
"during_the_day": [
{
"nakshatra": "Rohini",
"starts": "2026-09-30T20:32:55-04:00",
"ends": "2026-10-01T18:57:24-04:00",
"tara": 9,
"name": "Ati-Mitra",
"count_name": "Ati-Mitra",
"auspicious": true,
"severity": null,
"severity_reason": null,
"signifies": "the most favorable; support arrives without asking",
"reading": {
"text": [
"**Today is the most helpful step in your cycle of nine.** Count from your birth star, the nakshatra (star group) the Moon was in when you were born, to today's star. Today lands on the step of the great friend. Help tends to come without…",
"What you can do: use the day for something that matters to you. Make an important request or start a task you have planned. Still check the details before you commit."
],
"language": "en",
"detail": "standard"
}
},
{
"nakshatra": "Mrigashira",
"starts": "2026-10-01T18:57:24-04:00",
"ends": "2026-10-02T17:25:13-04:00",
"tara": 1,
"name": "Janma",
"count_name": "Janma",
"auspicious": false,
"severity": "strict",
"severity_reason": "the birth star itself. Classical texts strictly reject it for big beginnings such as marriage, long journeys and a new business",
"signifies": "the birth star and its 10th and 19th repeats. Best avoided for big new starts such as marriage, long travel or a new business",
"reading": {
"text": [
"**Today the Moon comes back to your birth star.** Your birth star is the nakshatra (star group) the Moon was in when you were born. Old texts say this day is best avoided for big new starts. Your feelings may also sit a little closer to…",
"What you can do: keep today for your usual work. Save big new starts, like a wedding, a long trip or a new business, for another day."
],
"language": "en",
"detail": "standard"
}
}
]
}
],
"rule": "counted from the natal Moon nakshatra to the day nakshatra, mod 9. The 1st (Janma: counts 1, 10 and 19), 3rd, 5th and 7th are unfavorable for a start; the 2nd, 4th, 6th, 8th and 9th are favorable. Of the Janma counts the 1st is strict and…"
}Example from a real call for New York, Oct 1, 2026. Long lists and texts are shortened.
Parameters, schemas and a test request in the interactive reference. Feature: Panchang and muhurat.
Panchang calendar for a month, with festivals and fasts
GET /v1/panchang/month
Returns one row per calendar day (sunrise to sunrise). Each row has the tithi (lunar day), nakshatra (lunar mansion), yoga and karana running at sunrise, and when each one ends. It also has the lunar month and the day's festivals and vrats (fasting days). This is what a printed Hindu calendar shows.
The days come from the same calculations as /v1/panchang/daily, /v1/festivals and /v1/vrats. So they agree for the same date and place.
An element can start and end between two sunrises. It is then never the one running at sunrise and would be missed, so each such element is listed in skipped. Printed calendars mark these as kshaya (skipped) tithis.
Each row also has day_yogas: the day's Anandadi yogas and the special yogas that form (Sarvartha Siddhi, Amrit Siddhi, Visha, Dwipushkar, Tripushkar, Ravi Yoga, Guru Pushya, Ravi Pushya), with times. disha_shool is the direction to avoid starting a trip toward. Readings and chandrashtama are on /v1/panchang/daily.
Lunar months in this view are named the amanta way (each month ends at the new moon) unless calendar asks for purnimanta. Both names are in masa. Without latitude, longitude and timezone, the calendar is for Ujjain, India.
The first request for a year and place takes about 8 seconds. It builds that year's festival and fasting calendars first. Later requests are cached.
Cost: Each successful request counts as 1 call toward your monthly calls.
Required inputs
| Name | In | What it is |
|---|---|---|
| year | query | Calendar year, from 1850 to 2149. |
| month | query | Month number, from 1 (January) to 12 (December). |
Optional inputs (5), with their defaults
| Name | In | What it does |
|---|---|---|
| latitude | query | Latitude in degrees, negative for south. Defaults to Ujjain, India. |
| longitude | query | Longitude in degrees, negative for west. Defaults to Ujjain, India. |
| timezone | query | IANA time zone name such as America/New_York, or a fixed offset from UTC in hours such as -5. Defaults to 5.5 (India time). |
| lang | query | Language for the names in the response, such as planets, signs, nakshatras (lunar mansions), tithis (lunar days), months and festivals. The default is en (English); GET /v1/meta lists the others. Each translated value comes with its English original in a matching <field>_en field; use the English value as a key in your code. Codes (such as result or kaal) and object keys always stay in English. Any name not yet translated stays in English and is listed in localization.untranslated. |
| calendar | query | How to name the lunar months: amanta or purnimanta. In amanta calendars (Maharashtra, Gujarat and South India) a month ends at the new moon. In purnimanta calendars (North India) it ends at the full moon. Only the name of the month in its waning half differs. Dates never change. Both names are always in the response (amanta and purnimanta), and this setting chooses which one goes in name. Other languages keep this endpoint's usual one. convention says which was used. |
Main response fields
year(number)month(number)place(object): holds latitude, longitude, timezone, timezone_info, note.days(array of objects): each item holds date, weekday, sunrise, sunset, tithi, nakshatra, yoga, karana, masa, skipped, festivals, vrats.convention(string)note(string)
# New York
curl "https://apiforastrology.com/api/astrology/v1/panchang/month?year=2026&month=10&latitude=40.7128&longitude=-74.006&timezone=America/New_York" \
-H "Authorization: Bearer $ASTROLOGY_API_KEY"{
"year": 2026,
"month": 10,
"place": {
"latitude": 40.7128,
"longitude": -74.006,
"timezone": -5,
"timezone_info": {
"source": "zone",
"offset_hours": -5,
"zone": "America/New_York",
"abbreviation": "EST",
"dst": false,
"dst_hours": 0,
"ambiguous_resolved_by_fold": null,
"note": "read from the IANA tz database at this instant, so daylight saving and historical offset changes are included"
},
"note": "this zone changes offset during the year; each time uses the offset in force on its own date (UTC-5 in January, UTC-4 in July) and ends with that offset"
},
"days": [
{
"date": "2026-10-01",
"weekday": "Thursday",
"sunrise": "2026-10-01T06:52:37-04:00",
"sunset": "2026-10-01T18:37:57-04:00",
"tithi": {
"index": 21,
"name": "Shashthi",
"paksha": "krishna",
"starts": "2026-10-01T03:05:43-04:00",
"ends": "2026-10-02T00:45:43-04:00"
},
"nakshatra": {
"index": 4,
"name": "Rohini",
"lord": "Moon",
"starts": "2026-09-30T20:32:55-04:00",
"ends": "2026-10-01T18:57:24-04:00"
},
"yoga": {
"index": 16,
"name": "Siddhi",
"starts": "2026-09-30T14:50:35-04:00",
"ends": "2026-10-01T11:48:23-04:00"
},
"karana": {
"index": 41,
"name": "Gara",
"starts": "2026-10-01T03:05:43-04:00",
"ends": "2026-10-01T13:55:24-04:00"
},
"masa": {
"name": "Bhadrapada",
"adhika": false,
"convention": "amanta",
"amanta": "Bhadrapada",
"purnimanta": "Asvina"
},
"skipped": [],
"festivals": [],
"vrats": [],
"day_yogas": {
"anandadi": [
{
"starts": "2026-10-01T06:52:37-04:00",
"ends": "2026-10-01T18:57:24-04:00",
"name": "Utpata",
"number": 16,
"nature": "inauspicious",
"nakshatra": "Rohini"
},
{
"starts": "2026-10-01T18:57:24-04:00",
"ends": "2026-10-02T06:53:38-04:00",
"name": "Mrityu",
"number": 17,
"nature": "inauspicious",
"nakshatra": "Mrigashira"
}
],
"special_yogas": [
{
"code": "ravi_yoga",
"name": "Ravi Yoga",
"nature": "auspicious",
"spans": [
{
"starts": "2026-10-01T18:57:24-04:00",
"ends": "2026-10-02T06:53:38-04:00",
"nakshatra": "Mrigashira",
"sun_nakshatra": "Hast",
"count": 20
}
]
}
]
},
"disha_shool": "south"
},
{
"date": "2026-10-02",
"weekday": "Friday",
"sunrise": "2026-10-02T06:53:38-04:00",
"sunset": "2026-10-02T18:36:17-04:00",
"tithi": {
"index": 22,
"name": "Saptami",
"paksha": "krishna",
"starts": "2026-10-02T00:45:43-04:00",
"ends": "2026-10-02T22:30:08-04:00"
},
"nakshatra": {
"index": 5,
"name": "Mrigashira",
"lord": "Mars",
"starts": "2026-10-01T18:57:24-04:00",
"ends": "2026-10-02T17:25:13-04:00"
},
"yoga": {
"index": 17,
"name": "Vyatipata",
"starts": "2026-10-01T11:48:23-04:00",
"ends": "2026-10-02T08:47:43-04:00"
},
"karana": {
"index": 43,
"name": "Vishti",
"starts": "2026-10-02T00:45:43-04:00",
"ends": "2026-10-02T11:37:09-04:00"
},
"masa": {
"name": "Bhadrapada",
"adhika": false,
"convention": "amanta",
"amanta": "Bhadrapada",
"purnimanta": "Asvina"
},
"skipped": [
{
"limb": "yoga",
"index": 18,
"name": "Variyana",
"starts": "2026-10-02T08:47:43-04:00",
"ends": "2026-10-03T05:51:39-04:00"
}
],
"festivals": [],
"vrats": [],
"day_yogas": {
"anandadi": [
{
"starts": "2026-10-02T06:53:38-04:00",
"ends": "2026-10-02T17:25:13-04:00",
"name": "Manasa",
"number": 13,
"nature": "auspicious",
"nakshatra": "Mrigashira"
},
{
"starts": "2026-10-02T17:25:13-04:00",
"ends": "2026-10-03T06:54:39-04:00",
"name": "Padma",
"number": 14,
"nature": "auspicious",
"nakshatra": "Ardra"
}
],
"special_yogas": [
{
"code": "ravi_yoga",
"name": "Ravi Yoga",
"nature": "auspicious",
"spans": [
{
"starts": "2026-10-02T06:53:38-04:00",
"ends": "2026-10-02T17:25:13-04:00",
"nakshatra": "Mrigashira",
"sun_nakshatra": "Hast",
"count": 20
}
]
}
]
},
"disha_shool": "west"
},
{
"date": "2026-10-03",
"weekday": "Saturday",
"sunrise": "2026-10-03T06:54:39-04:00",
"sunset": "2026-10-03T18:34:39-04:00",
"tithi": {
"index": 23,
"name": "Ashtami",
"paksha": "krishna",
"starts": "2026-10-02T22:30:08-04:00",
"ends": "2026-10-03T20:22:13-04:00"
},
"nakshatra": {
"index": 6,
"name": "Ardra",
"lord": "Rahu",
"starts": "2026-10-02T17:25:13-04:00",
"ends": "2026-10-03T15:59:54-04:00"
},
"yoga": {
"index": 19,
"name": "Parigha",
"starts": "2026-10-03T05:51:39-04:00",
"ends": "2026-10-04T03:02:24-04:00"
},
"karana": {
"index": 45,
"name": "Balava",
"starts": "2026-10-02T22:30:08-04:00",
"ends": "2026-10-03T09:25:03-04:00"
},
"masa": {
"name": "Bhadrapada",
"adhika": false,
"convention": "amanta",
"amanta": "Bhadrapada",
"purnimanta": "Asvina"
},
"skipped": [],
"festivals": [],
"vrats": [],
"day_yogas": {
"anandadi": [
{
"starts": "2026-10-03T06:54:39-04:00",
"ends": "2026-10-03T15:59:54-04:00",
"name": "Mudgara",
"number": 10,
"nature": "inauspicious",
"nakshatra": "Ardra"
},
{
"starts": "2026-10-03T15:59:54-04:00",
"ends": "2026-10-04T06:55:41-04:00",
"name": "Chhatra",
"number": 11,
"nature": "auspicious",
"nakshatra": "Punarvasu"
}
],
"special_yogas": []
},
"disha_shool": "east"
}
],
"convention": "amanta",
"note": "the limbs are those running at sunrise, each with its end; `skipped` lists any that begin and end between two sunrises. The month is named amanta; `masa.amanta` and `masa.purnimanta` give both names."
}Example from a real call for New York. Long lists and texts are shortened.
Parameters, schemas and a test request in the interactive reference. Feature: Hindu calendar and festivals.
How we check the numbers
Every answer here starts from planet positions worked out from NASA JPL planet data (DE440). We test them against NASA JPL Horizons, NASA's planet position service. On 25,571 positions from 1850 to 2149, the Sun and planets agree within 0.001 arc seconds. The Moon agrees within 0.011. On 2,000 random birth charts, the rising sign agrees with Swiss Ephemeris within 0.004 arc seconds. An arc second is 1/3,600 of a degree. A practicing astrologer reviews the rules behind these answers. See how we test accuracy.
Related pages
- Features: Panchang and muhurat, Hindu calendar and festivals.
- Used for: Puja and spiritual stores, Publishers and media, Astrology apps, Baby name apps.
- Free tools: Today's panchang.
- Rules: Panchang, Muhurat and times of the day.
- Guides: Quickstart, Conventions, Errors, Changelog.
