General House Report Generation

What is the General House Report endpoint?

You need an interpretive reading for a specific planet's house placement (Sun in the 8th, Moon in the 4th, Mars in the 10th, etc.). The General House Report endpoint takes birth data plus a planet name in the URL path and returns a structured five-section report covering how that planet's life-area placement plays out across themes, strengths, and challenges.

This endpoint is part of the Natal Chart API.

Why does this endpoint exist?

You are building "your Sun in the 8th house" or "your Mars in the 10th" content and you do not want to hand-author 120 reading variants (ten bodies times twelve houses). The endpoint hands you that whole matrix on demand. Pass the planet, the API computes its house, and returns the matching reading in any of twelve languages.

What inputs does it need?

You pass the planet name as a path segment in the endpoint URL (/sun, /moon, /mercury, etc.) and standard birth data in the body. The API calculates which house the requested planet falls in for that birth and returns the matching report. Authentication uses a Bearer token in the Authorization header.

What does the response data look like?

You get a data object with the planet name, the house number it falls in, and a report array of five themed sections. Each section has a heading and a description, structured for direct rendering as cards or accordion panels.

The five sections cover the planet's expression in that house's life area, emotional themes, strengths, challenges, and life direction. Headings adapt to the planet-house combination, not just the house number.

What does a real response look like?

Below is the response for a sample birth (24 May 2023, 14:40:43 IST, New Delhi) querying /sun. The Sun falls in the 8th house under Placidus, so the report covers Sun-in-8th-house themes across five sections.

{
  "success": 1,
  "data": {
    "planet_name": "Sun",
    "house": 8,
    "report": [
      {
        "heading": "Unlocking Life's Mysteries",
        "description": "With the Sun in the eighth house, you are drawn to life's deeper mysteries. This placement encourages a profound understanding and transformation, constantly propelling you towards personal and spiritual growth."
      },
      {
        "heading": "Navigating Deep Waters",
        "description": "Your emotional landscape is rich and complex, inviting you to explore hidden facets of your psyche. The Sun in this position enhances your capacity for deep emotional connections and psychological healing."
      },
      {
        "heading": "Strength in Intuition",
        "description": "You possess enhanced intuitive and possibly psychic abilities that allow you to perceive beyond the surface. Trusting your deep-seated instincts serves as a guide through intricate human emotions and motives."
      },
      {
        "heading": "Potential Power Struggles",
        "description": "Your placement may challenge you with power dynamics, especially in relationships. Learning to balance personal power with sensitivity to others' needs is crucial for your emotional and relational growth."
      },
      {
        "heading": "Focusing on Transformation",
        "description": "Your life themes revolve around transformation, shared resources, and facing the shadow self. Embracing change and exploring metaphysical practices can illuminate your path to personal empowerment."
      }
    ]
  }
}

What can you build with this endpoint?

You use the General House Report whenever your product needs structured interpretive content for a planet's house placement. The structured report array maps cleanly to cards or accordions, and the per-planet endpoint design composes naturally into multi-planet personality reports.

1. House-by-house personality pages. Loop over Sun, Moon, Mercury, Venus, Mars. Concat the responses for a complete planet-in-house writeup.
2. Card-based UI. Render each report entry as a card with heading as title and description as body.
3. PDF reports. Combine multiple planet calls into a single downloadable document with consistent section structure.
4. Sign + house combo reports. Pair this endpoint with the General Sign Report to deliver "Sun in Gemini in the 8th" style readings.

How accurate is the calculation?

You are surfacing reading content tied to a specific house placement, so the calculation has to land on the correct house. The endpoint pulls planet positions from Swiss Ephemeris with NASA JPL ephemeris data and assigns each to a house using the house_system you specified. The reading matches the planet-house combination computed for the given birth.

House placement depends on birth time precision more than sign placement does. A planet near a house cusp can shift houses with a small time difference, so an unknown birth time makes house-based readings less reliable. Treat birth-time-unknown results as approximate.

How does this relate to the parent API?

You are wrapping each planet-house placement with reader-facing interpretation. This endpoint complements the Natal Chart API by providing structured five-section interpretive reports for any planet's house placement.

Planetary Positions tells you the house number for each planet. House Cusps tells you where the house boundaries sit. This endpoint adds the prose for the combination. Together with the General Sign Report, you cover both sign and house dimensions of every placement.

Summary

The General House Report endpoint returns a structured five-section interpretive reading for a planet's house placement. You pass the planet in the URL path, the API computes the matching house for the birth, and the response delivers a report array with heading and description fields. Pair it with Planetary Positions and the General Sign Report to build complete planet-by-planet personality writeups in twelve languages.