Horoscope Chart Image Extended
The Horoscope Chart Image Extended API is the most comprehensive endpoint in the horoscope chart family. It combines the visual rendering capability of the Horoscope Chart Image endpoint with the enriched planetary data payload of the Horoscope Chart Extended endpoint — returning both a fully customisable rendered chart image and detailed astrological data for each planetary placement in a single response. It supports the same full range of divisional charts (Vargas) and special charts as the rest of the chart family.
What This API Does
This endpoint accepts a person's birth date, time, and geographic coordinates, a chartId path parameter specifying which chart to generate, and a comprehensive set of visual styling parameters. It computes the planetary positions, house placements, and extended astrological attributes for the requested chart type, then renders the chart as a styled image while simultaneously returning the rich structured data that underpins it.
The result is a single-call solution for applications that need to display a chart image alongside a detailed data breakdown — eliminating the need to call both the image endpoint and the extended data endpoint separately. The visual output is fully customisable: chart style (North, South, or East Indian layout), colours, line widths, chart size, font sizes, and symbol/text display preferences are all configurable via the request body.
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
The response combines the visual output of the image endpoint with the enriched data payload of the extended endpoint, which may include:
- Rendered chart image — a fully styled visual representation of the horoscope chart in the requested regional layout (North, South, or East Indian), ready for direct display or embedding
- 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, modality, 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
- Applied styling confirmation — the visual configuration used to render the image
Main Use Cases
- All-in-one chart pages: Powering a single API call that populates both the visual chart and the accompanying data table or planet list on a horoscope detail page, reducing round trips and simplifying client logic
- Premium horoscope reports: Generating richly detailed, visually styled chart images alongside full planetary breakdowns for inclusion in premium PDF reports or personalised horoscope documents
- Branded divisional chart analysis: Rendering specific Varga charts (D9 Navamsa, D10 Dashamsa, D60 Shashtiamsa, etc.) with custom styling while simultaneously retrieving the extended planetary data needed for interpretation
- Multi-tradition chart display: Producing charts in North, South, or East Indian styles with full extended data, catering to users from different regional astrological traditions without requiring separate calls
- Astrology dashboards: Serving as the primary data source for dashboard views that display a chart image, planet table, house lord summary, and dignity indicators all on the same screen
- Efficiency-optimised integrations: Replacing two separate calls (one to the image endpoint, one to the extended data endpoint) with a single request, reducing latency and API usage for high-traffic applications
Key Functionality
- Combines image rendering and extended data in a single response — the most complete endpoint in the chart family, eliminating the need to call both the image and extended data endpoints separately
- Supports three regional chart styles — North Indian, South Indian, and East Indian — via the
chartStyle parameter
- Offers comprehensive visual customisation through body parameters: background colour, inner/outer line colours and widths, sign colour, planet colour, chart size, sign font size, planet font size, sign symbol/number toggle, and planet symbol/name toggle
- Returns enriched planetary attributes alongside the image: nakshatra details, dignity indicators, house lord mappings, sign attributes, and planetary relationships — identical to the Horoscope Chart Extended data payload
- 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
- 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 labels
- The most efficient single endpoint when both a rendered chart image and detailed planetary data are required together
