SEARCH ASTRO INSIGHT API DOCS
The Inauspicious 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/inauspicious-period
en
hi
ma
Methodology and astrological context for Inauspicious Period.
The Inauspicious Period API returns a focused, structured list of all unfavourable time windows for a given date and geographic location, derived from classical Vedic astrology and Panchang principles. This endpoint is the dedicated counterpart to the Auspicious Period API — rather than returning the full spectrum of daily timings, it isolates only the periods that Vedic tradition identifies as harmful or obstructive, making it a precise tool for avoidance-based scheduling.
This endpoint analyses the Panchang for the specified date, time, and location and returns a structured list of named inauspicious periods with their precise start and end times. All calculations are anchored to the astronomical sunrise at the provided coordinates, and the Ayanamsha system is configurable via a request header to support different Vedic schools of thought.
The response provides a complete set of inauspicious time periods for the day, typically including:
Rahu Kalam — The most widely observed inauspicious period of the day, governed by the shadow planet Rahu; strongly avoided for new ventures, travel, and important decisions
Gulika Kalam — An unfavourable window associated with Gulika (Mandi), the son of Saturn, considered inauspicious for auspicious activities
Yamaganda — An inauspicious period associated with Yama, the lord of death; avoided for all significant undertakings
Dur Muhurta — Specific inauspicious time slots during the day that are considered harmful for starting new activities
Varjyam — A period of particular negativity derived from the Moon's Nakshatra; considered highly unfavourable for all activities
Bhadra (Vishti Karana) — An inauspicious half-tithi period that recurs periodically and is avoided for auspicious events
Sunrise and Sunset times — The anchor points from which all inauspicious period timings are calculated
Avoidance scheduling — Enabling users, astrologers, and apps to clearly identify and avoid all inauspicious windows when planning important activities such as travel, business, medical procedures, or ceremonies
Muhurta validation — Serving as a negative filter in muhurta (electional astrology) workflows to automatically flag or reject time slots that fall within inauspicious periods
Daily planning and productivity apps — Powering a "times to avoid" feature in astrology or wellness apps that warn users before they schedule important tasks during harmful windows
Wedding and event planning platforms — Helping planners and priests ensure that key rituals and ceremonies do not overlap with Rahu Kalam, Gulika Kalam, or other inauspicious periods
Notification and alert systems — Triggering reminders or warnings to users when an upcoming inauspicious period (e.g., Rahu Kalam) is about to begin
Inauspicious-period focused — Unlike general Panchang endpoints, this API is purpose-built to return only the unfavourable time windows of the day, providing a clean, actionable dataset for avoidance-based use cases
Complete inauspicious coverage — Returns all major Vedic inauspicious periods in a single response — Rahu Kalam, Gulika Kalam, Yamaganda, Dur Muhurta, Varjyam, and Bhadra — with precise start and end times
Sunrise-anchored calculations — All period timings are derived from the actual astronomical sunrise at the specified location, ensuring alignment with traditional Panchang methodology
Location-aware — Uses latitude, longitude, and timezone offset to compute the local sunrise and derive all inauspicious period timings for 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, supporting diverse user bases
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 Inauspicious Period.
The Inauspicious 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 Inauspicious 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 Inauspicious Period consumes 1 API credit. The endpoint delivers high performance with an average response time of ~61ms.
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.