SEARCH ASTRO INSIGHT API DOCS

Pancha Pakshi By Date

The Pancha Pakshi By Date API calculates a person's Pancha Pakshi (Five Birds) activity schedule for a specific target date, rather than the current day. By accepting both birth details and a separate reference date, this endpoint enables forward planning, historical lookups, and date-specific auspiciousness analysis using the classical South Indian Vedic timing system.

What This API Does

This endpoint derives the ruling bird for a person from their birth nakshatra and lunar phase, then computes the full five-bird activity schedule for a user-specified date (cDay, cMonth, cYear). Unlike the standard Pancha Pakshi endpoint which calculates cycles for today, this variant allows the caller to query the bird activity schedule for any date — past, present, or future — making it particularly suited for advance muhurta planning and retrospective analysis.

The Ayanamsha system is configurable via the X-Ayanamsha header, and multi-language support is available through the Accept-Language header.

What Data It Returns

The response provides comprehensive Pancha Pakshi data for the specified target date, which may include:

• Ruling bird of the person derived from their birth nakshatra and paksha (lunar fortnight)
• Five birds and their respective activities for each time division of the target day
• Activity type for each bird in each time slot — ruling, eating, walking, sleeping, or dying
• Auspiciousness rating or strength indicator for each time period based on the ruling bird's activity on the target date
• Day bird and night bird assignments for the target date, reflecting the day/night cycle split
• Nakshatra and paksha used to derive the ruling bird
• Time division boundaries for each of the five daily segments on the target date

Main Use Cases

• Advance muhurta planning: Querying future dates to identify the most auspicious time windows for weddings, business launches, travel, surgeries, or other significant events well ahead of time
• Event scheduling tools: Allowing users to compare multiple upcoming dates and select the one with the most favourable Pancha Pakshi activity for their ruling bird
• Historical analysis: Looking up the bird activity schedule for past dates to correlate auspicious periods with real-life outcomes
• Vedic astrology and calendar apps: Powering date-picker features that highlight auspicious days and time slots based on a user's personal Pancha Pakshi profile
• Holistic planning platforms: Combining date-specific Pancha Pakshi data with biorhythm projections and astrological transits for comprehensive future guidance