General Sign Report Generation

What is the General Sign Report endpoint?

You need an interpretive reading for a specific planet's sign placement (Sun in Gemini, Moon in Cancer, Mercury in Taurus, etc.). The General Sign Report endpoint takes birth data plus a planet name in the URL path and returns a structured five-section report with headings and descriptions, ready to display as an article or accordion.

This endpoint is part of the Natal Chart API.

Why does this endpoint exist?

You are building "your Sun is in Gemini" content and you do not want to hand-author 144 reading variants (twelve planets times twelve signs). The General Sign Report endpoint hands you that whole matrix on demand. Pass the planet, the API computes which sign it falls in, 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 request body. The API computes which sign the requested planet falls in for that birth, then returns the report for that planet-sign combination. 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 sign that planet falls in, and a report array of five themed sections. Each report section has a heading and a description, mapping cleanly to a card layout, accordion panel, or expandable section in your UI.

The five sections cover core essence, emotional currents, strengths, challenges, and life direction. Headings stay consistent across sign variants; descriptions adapt to the specific planet-sign combination.

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 Gemini, so the report covers Sun-in-Gemini themes across five sections.

{
  "success": 1,
  "data": {
    "planet_name": "Sun",
    "sign_name": "Gemini",
    "report": [
      {
        "heading": "Core Essence Explored",
        "description": "With the Sun in Gemini, your essence is marked by a dynamic intellectual curiosity and a vibrant communicative flair. This positioning shapes your identity into one of versatility and adaptability, flourishing in stimulating mental environments."
      },
      {
        "heading": "Navigating Emotional Currents",
        "description": "Geminis are drawn to intellectual bonds in relationships, often placing high value on mental compatibility. While your social charm can lead to superficial connections, deeper emotional intimacy remains a conscious area for growth."
      },
      {
        "heading": "Harnessing Gemini Strengths",
        "description": "Your Gemini Sun gifts you with a quick wit, agile mind, and exceptional communication skills, making you naturally excel in areas that require intellectual engagement, such as writing or teaching."
      },
      {
        "heading": "Encountering Gemini Challenges",
        "description": "The shadow of your Gemini Sun includes a restless energy and a tendency towards scattered focus. Embracing consistency and diving deeper rather than wider in your intellectual pursuits can transform these obstacles into strengths."
      },
      {
        "heading": "Life's Intellectual Journey",
        "description": "The mission for a Gemini Sun person is to utilize their versatile and intellectual nature to connect and communicate effectively. Balancing their expansive curiosity with sustained focus will lead to profound personal and professional achievements."
      }
    ]
  }
}

What can you build with this endpoint?

You use the General Sign Report whenever your product needs structured interpretive content for a planet's sign placement, broken into themed sections. The structured report array maps cleanly to cards or accordions, and the per-planet endpoint design lets you compose larger personality reports by chaining calls.

1. Personality report pages. Loop over Sun, Moon, Mercury, Venus, and Mars. Concat the results for a complete planetary personality writeup.
2. Card-based UI. Render each report entry as a standalone card with the heading as title and description as body.
3. PDF reports. Combine multiple planet calls into a single downloadable document.
4. Localized natal apps. Toggle the lan parameter per user locale to ship readings in twelve languages.

How accurate is the calculation?

You are surfacing reading content tied to a specific astrological placement, so the calculation has to land on the correct sign. The endpoint pulls positions from Swiss Ephemeris with NASA JPL ephemeris data, then maps each to its zodiac sign. The reading matches the planet-sign combination computed for the given birth.

If a planet sits within minutes of a sign cusp, the reading reflects whichever sign the planet falls into by exact ecliptic position. Birth time matters most for fast-moving bodies like the Moon, which can change signs within hours.

How does this relate to the parent API?

You are wrapping each planet-sign placement with reader-facing interpretation, and this endpoint covers that for every planet on demand. This endpoint complements the Natal Chart API by providing structured five-section interpretive reports for any planet's sign placement.

Planetary Positions tells you which sign each planet falls in; this endpoint adds the prose for that placement. Render the chart visually with Planetary Positions, then layer interpretation panels from the General Sign Report on top.

Summary

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