POST/v1/astro/panchanga
Daily Panchanga
Vedic Panchanga for a date and location. The top-level tithi, vara, nakshatra, yoga and karana are the limbs at sunrise (or at time when given). The rest describes the whole panchanga day, sunrise to next sunrise: every tithi, nakshatra, yoga and karana active in it with ISO start and end times and kshaya/vriddhi flags; sunrise, sunset, moonrise and moonset; Sun and Moon rashi; lunar month in amanta and purnimanta reckoning (with Adhik months); Vikram, Shaka and Gujarati samvat; ritu and ayana; and the day's timings: Rahu Kaal, Gulika, Yamaganda, Abhijit, Brahma Muhurta, Durmuhurta, Varjyam, Amrit Kaal, Bhadra, Panchaka, Pradosh and others.
Request parameters
locationoptional
string | null
City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.
nameoptional
string | null
Optional. Name is not used in panchanga calculations.
daterequired
string
Birth date in YYYY-MM-DD format
timeoptional
string | null
Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.
latitudeoptional
number | null
Latitude. Required if location not provided.
longitudeoptional
number | null
Longitude. Required if location not provided.
timezoneoptional
string | null
IANA timezone. Required if location not provided (unless utc_offset is given). For dates before the zone adopted a standard time, the birthplace's local mean time (longitude / 15 hours) is used.
utc_offsetoptional
string | null
Optional explicit UTC offset for the local date and times, as ±HH:MM or ±HH:MM:SS. Overrides the offset
timezone would give.ayanamsaoptional
string
Sidereal ayanamsa mode used in calculations
dayoptional
string
sunrise (default): the panchanga day runs from this date's sunrise to the next. civil: also return civil_day, the windows that fall between local midnight and midnight of this date, for calendar-day apps. The sunrise-day fields are unchanged.
Response fields
success
boolean
True if the request succeeded
message
string
Human-readable status message
data
object
tithi, vara, nakshatra, yoga and karana are the limbs at one instant: sunrise when no time is given, otherwise the given time. The remaining fields describe the whole panchanga day containing that instant (sunrise to next sunrise): every limb active in it, sunrise and moonrise, lunar month, samvat, season and the day's timings.data.date
string | null
Civil date whose sunrise opens this panchanga day.
data.timezone
string | null
data.sunrise
string | null
Sun's upper limb on the horizon, standard refraction. ISO 8601 local time with UTC offset, e.g. 2026-11-06T10:31:09+05:30.
data.sunset
string | null
data.next_sunrise
string | null
data.moonrise
string | null
First moonrise between this sunrise and the next (disc centre, no refraction). Null if none.
data.moonset
string | null
First moonset between this sunrise and the next. Null if none.
data.day_duration_minutes
number | null
data.night_duration_minutes
number | null
data.paksha
string | null
Paksha at sunrise.
data.tithis
array[DayTithi] | null
Every tithi active between this sunrise and the next, with start and end.
data.nakshatras
array[DayNakshatra] | null
data.yogas
array[DayYoga] | null
data.karanas
array[DayKarana] | null
data.sun_rashi
array[SignSpan] | null
data.moon_rashi
array[SignSpan] | null
data.sun_nakshatra
array[NakshatraSpan] | null
data.masa
Masa | null
data.samvat
Samvat | null
data.ritu
Ritu | null
data.ayana
Ayana | null
data.timings
DayTimings | null
data.tithi
object
data.tithi.number
integer
Tithi number, 1 to 30
data.tithi.name
string
Tithi name, e.g. Pratipada, Purnima, Amavasya
data.tithi.paksha
string
Paksha — Shukla (waxing) or Krishna (waning)
data.tithi.degrees_elapsed
number
Degrees completed within the current tithi
data.tithi.degrees_remaining
number
Degrees remaining until the next tithi
data.tithi.end_time
string | null
data.vara
object
data.vara.number
integer
Weekday number, 1 to 7
data.vara.name
string
Weekday name in Sanskrit, e.g. Ravivar, Somvar
data.vara.lord
string
Planetary lord of the weekday, e.g. Sun, Moon
data.vara.end_time
string | null
data.nakshatra
object
data.nakshatra.index
integer
Zero-based nakshatra index, 0 to 26
data.nakshatra.name
string
Nakshatra name, e.g. Ashwini, Revati
data.nakshatra.pada
integer
Pada number, 1 to 4
data.nakshatra.degrees_elapsed
number
Degrees completed within the current nakshatra
data.nakshatra.degrees_remaining
number
Degrees remaining until the next nakshatra
data.nakshatra.end_time
string | null
data.yoga
object
data.yoga.index
integer
Zero-based yoga index, 0 to 26
data.yoga.name
string
Yoga name, e.g. Vishkumbha, Shiva
data.yoga.is_inauspicious
boolean
True if this yoga is considered inauspicious
data.yoga.degrees_elapsed
number
Degrees completed within the current yoga
data.yoga.end_time
string | null
data.karana
object
data.karana.number
integer
Karana number, 1 to 60
data.karana.name
string
Karana name
data.karana.degrees_elapsed
number
Degrees completed within the current karana
data.karana.degrees_remaining
number
Degrees remaining until the next karana
data.karana.end_time
string | null
data.civil_day
CivilDay | null
Present when day=civil: the windows of the calendar day.
Errors
Invalid API key format.
API key is missing. Include it in the Authorization header as 'Bearer YOUR_KEY'.
The provided API key was not found. Verify the key in your Asterwise dashboard.
This API key has been revoked.
Too many requests per minute. Please slow down.
Something went wrong on our end. Please try again, or contact [email protected] if the problem persists. Include your request_id when contacting support.
Too many requests from this IP address. Please slow down.
Monthly API call limit reached. Upgrade your plan to continue.
Request body exceeds maximum allowed size of 64KB.
Your subscription has expired. Please renew at asterwise.com/dashboard to continue.
The request couldn't be processed. See the 'details' field for specific field-level issues.