Horoscope Chart Extended API

Horoscope Chart Extended

The Horoscope Chart Extended API is the enriched variant of the Horoscope Chart endpoint. It generates a Vedic astrology horoscope chart for a given birth profile and chart type, and returns a significantly more detailed data payload than the standard chart endpoint — including deeper planetary attributes, additional astronomical data, and richer contextual information for each placement. It supports the same comprehensive set of divisional charts (Vargas) and special charts as the base endpoint.

What This API Does

This endpoint accepts a person's birth date, time, and geographic coordinates, along with a chartId path parameter specifying which chart to generate. It performs the same core astronomical computation as the Horoscope Chart endpoint — calculating planetary positions, house cusps, and sign placements for the requested chart type — but returns an extended response with additional layers of detail for each planet and house.

The /extended suffix distinguishes this endpoint from the standard chart endpoint: where the base endpoint returns a concise chart representation suitable for rendering, this endpoint returns a richer dataset designed for in-depth analysis, detailed report generation, or applications that need to display comprehensive astrological attributes alongside the chart.

The chart type is controlled by the chartId path parameter, supporting the full range of divisional charts from D1 through D150, as well as the Moon chart, Sun chart, and Chalit chart. The Ayanamsha system is configurable via the X-Ayanamsha header, and multi-language output is supported via the Accept-Language header.

What Data It Returns

In addition to the core chart data returned by the standard Horoscope Chart endpoint, the extended response provides enriched attributes for each planetary placement, which may include:

• Full planetary details — zodiac sign, house, degree, minutes, seconds, and retrograde status for each planet in the selected chart
• Nakshatra details — nakshatra name, pada, nakshatra lord, and sub-lord for each planet
• Dignity and strength indicators — exaltation, debilitation, own sign, Moolatrikona, and friendly/enemy sign status for each planet
• House lord mappings — the ruling planet for each of the twelve houses in the chart
• Ascendant (Lagna) details — rising sign, degree, nakshatra, and nakshatra lord
• Extended sign attributes — element (fire/earth/air/water), modality (cardinal/fixed/mutable), and gender for each occupied sign
• Planetary relationships — natural and temporal friendships/enmities between planets as relevant to the chart
• Chart metadata — chart type identifier, Ayanamsha used, and birth details echoed back for confirmation

Main Use Cases

• Detailed horoscope reports: Generating comprehensive birth chart reports that display full planetary attributes — degrees, nakshatras, dignity status, house lords — alongside the chart image, for professional or premium astrology applications
• In-depth divisional chart analysis: Performing thorough analysis of specific Varga charts (D9 Navamsa, D10 Dashamsa, D60 Shashtiamsa, etc.) where extended planetary data is needed for interpretation
• Astrological matching and compatibility: Using the enriched planetary and nakshatra data from multiple charts to perform detailed compatibility assessments
• Strength and dignity calculations: Powering Shadbala, Ashtakavarga, or other strength-based calculations that require precise degree, dignity, and relationship data for each planet
• Professional astrology platforms: Serving as the primary data source for platforms that display detailed chart breakdowns, planet tables, and house lord summaries alongside the visual chart
• Research and pattern analysis: Enabling data-driven astrological research by providing rich, structured planetary data across multiple chart types for a given birth profile

Key Functionality

• Returns extended planetary data beyond the standard chart endpoint, including nakshatra details, dignity indicators, house lord mappings, and sign attributes for each placement
• Supports 25+ chart types via the chartId path parameter, covering all major Varga divisional charts (D1 through D150), the Chalit chart, Moon chart, and Sun chart — identical chart type coverage to the base endpoint
• Accepts birth date, time, and geographic coordinates (latitude, longitude, timezone) for precise astronomical calculations
• Configurable Ayanamsha system via the X-Ayanamsha header, supporting multiple Vedic traditions (e.g., Lahiri, Krishnamurti, Raman)
• Supports multi-language responses via the Accept-Language header for localised planet, sign, and nakshatra names
• Designed as the data-rich counterpart to the standard Horoscope Chart endpoint — use the base endpoint for chart rendering, and this endpoint when detailed planetary attributes are required
• Enables dynamic chart switching across all supported chart types by changing only the chartId, without altering the birth data payload