SEARCH ASTRO INSIGHT API DOCS
The Auspicious Period API provides Panchang related calculations and insights based on Vedic Astrology principles. This endpoint is designed for astrology applications, report generation systems, horoscope platforms, and developer integrations requiring structured JSON responses and reliable REST API access.
https://json.astroinsightapi.com/api/v1/panchang/auspicious-period
en
hi
ma
Methodology and astrological context for Auspicious Period.
The Auspicious Period API identifies and returns all favourable and unfavourable time windows for a given date and geographic location, based on classical Vedic astrology and Panchang principles. Rather than returning the full almanac, this endpoint focuses specifically on the timing dimension — surfacing the precise start and end times of auspicious and inauspicious periods throughout the day so that users can plan important activities accordingly.
This endpoint analyses the Panchang elements for the specified date, time, and location and derives a structured list of named time periods that are considered either auspicious (Shubh) or inauspicious (Ashubh) according to Vedic tradition. Calculations are performed using the astronomical sunrise for the given coordinates, and the Ayanamsha system is configurable via a request header to support different Vedic schools.
The response provides a comprehensive breakdown of daily time periods, typically including:
Abhijit Muhurta — The most universally auspicious time window of the day, occurring near solar noon
Brahma Muhurta — The highly auspicious pre-dawn period ideal for spiritual practice and new beginnings
Rahu Kalam — The daily inauspicious period governed by Rahu, to be avoided for important undertakings
Gulika Kalam — An inauspicious window associated with Gulika (son of Saturn)
Yamaganda — An inauspicious period associated with Yama, the lord of death
Dur Muhurta — Inauspicious time slots during the day that should be avoided
Varjyam — A period considered particularly unfavourable for all activities
Amrit Kalam — An auspicious window considered highly beneficial for important tasks
Choghadiya — The traditional Gujarati/Rajasthani system of eight daily time segments, each classified as auspicious, inauspicious, or neutral
Hora — Planetary hours of the day, each ruled by a specific planet, indicating the nature of activities best suited to that window
Sunrise and Sunset times — The anchor points used to compute all period timings
Muhurta selection — Helping individuals and astrologers identify the best time windows for starting important activities such as travel, business launches, property purchases, medical procedures, or ceremonies
Daily planning apps — Powering a "best time to act" feature in astrology, wellness, or productivity apps that surface auspicious windows for the user's current location
Wedding and event planning — Providing precise auspicious and inauspicious periods to help plan the timing of rituals, ceremonies, and celebrations
Devotional and spiritual apps — Surfacing Brahma Muhurta and other spiritually significant windows for meditation, prayer, and worship scheduling
Avoidance scheduling — Enabling users to steer clear of Rahu Kalam, Gulika Kalam, Yamaganda, and other inauspicious periods when scheduling important meetings or decisions
Focused on timing — Unlike general Panchang endpoints, this API is purpose-built to return a complete, structured list of named time periods with precise start and end times, making it directly actionable for scheduling
Covers both auspicious and inauspicious periods — Returns the full spectrum of Vedic time classifications in a single response, from the most favourable (Abhijit Muhurta, Amrit Kalam) to the most unfavourable (Rahu Kalam, Varjyam)
Sunrise-anchored calculations — All period timings are derived from the actual astronomical sunrise at the specified location, ensuring traditional accuracy
Location-aware — Uses latitude, longitude, and timezone offset to compute sunrise and derive all period timings specific to any location worldwide
Configurable Ayanamsha — The X-Ayanamsha header allows selection of the sidereal correction system (e.g., Lahiri, Raman, KP), ensuring compatibility with different Vedic astrology traditions
Multi-language support — The Accept-Language header enables period names and labels to be returned in the preferred regional or vernacular language
Payload specifications for JSON request body.
| Parameter | Type | Description & Example |
|---|---|---|
|
day
Required
|
integer |
Day of birth (1–31).
Example:
15
|
|
month
Required
|
integer |
Month of birth (1–12).
Example:
9
|
|
year
Required
|
integer |
Year of birth (e.g., 1994).
Example:
1994
|
|
hour
Required
|
integer |
Hour of birth in 24-hour format (0–23).
Example:
12
|
|
min
Required
|
integer |
Minute of birth (0–59).
Example:
30
|
|
sec
Optional
|
integer |
Second of birth (0–59). Optional. If not provided, it is considered as 0.
Example:
30
|
|
lat
Required
|
float |
Latitude of the birth location.
Example:
28.6139
|
|
lon
Required
|
float |
Longitude of the birth location.
Example:
77.1025
|
|
tzone
Optional
|
float |
Timezone offset from UTC. Optional. If not provided, it is considered as 5.5 (IST).
Example:
5.5
|
| Header Key | Value / Format | Description |
|---|---|---|
|
Authorization
Required
|
Basic {base64} |
Base64 encoded string of CLIENT_ID:CLIENT_SECRET. |
|
Content-Type
Required
|
application/json |
Specifies JSON payload format in request body. |
|
Accept-Language
Optional
|
en, hi, ta, te... |
Returns localized astrology output. Default: en |
|
X-Ayanamsha
Optional
|
lahiri, raman, krishnamurti... |
Ayanamsha system: lahiri, raman, fagan_bradley, usha_shashi, krishnamurti, djwhal_khul, yukteshwar, jn_bhasin, suryasiddhanta, aryabhata. Default: lahiri |
Explore complementary endpoints in this category.
Comprehensive developer guidance for Auspicious Period.
The Auspicious Period API provides authentic Panchang calculations based on Vedic astrology algorithms. It returns structured JSON data containing detailed planetary positions, house calculations, and astrological parameters suitable for Kundli apps, astrology websites, and developer applications.
The Auspicious Period API requires standard Vedic birth details: day, month, year, hour, min, sec, latitude (lat), longitude (lon), and timezone (tzone). All parameters can be passed in the JSON request body.
Each calculation request to Auspicious Period consumes 1 API credit. The endpoint delivers high performance with an average response time of ~78ms.
Authenticate using HTTP Basic Authentication by including your Base64 encoded client_id:client_secret credentials in the Authorization header (Authorization: Basic BASE64(client_id:client_secret)).
Yes! The API supports multiple languages including English, Hindi, Marathi. Pass your desired language code (e.g. 'hi' for Hindi, 'ta' for Tamil, 'en' for English) in the Accept-Language request header.
Supported Ayanamshas include NC Lahiri (Default), BV Raman, Krishnamurti (KP), Fagan Bradley, Usha Shashi, Djwhal Khul, Sri Yukteshwar, JN Bhasin, Surya Siddhanta, and Aryabhata. Specify your choice using the X-Ayanamsha header.
The API returns clean JSON UTF-8 output. Successful requests return HTTP 200 OK with the computed data payload. Parameter validation errors return HTTP 422 with actionable error messages.