Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Fixed Stars → Report

AI-generated

Summary

Generate a detailed fixed stars astrological report based on the subject's birth data and location, including selected star presets and aspect orbs, optionally with interpretations.

Inputs

  • subjectName (required) — Full name for numerology calculations (required for name-based numbers).
  • year (required) — Birth year in 4-digit format (e.g., 1990).
  • month (required) — Birth month as number 1-12 (January=1, December=12).
  • day (required) — Birth day of month (1-31).
  • hour (required) — Birth hour in 24-hour format (0-23, where 0=midnight, 12=noon).
  • minute (required) — Birth minute (0-59).
  • locationType (required) — Choose how to specify birth location: by city name (auto-detects coordinates) or exact latitude/longitude.
  • city (required) — Birth city name if location type is 'city' (e.g., "London", "New York", "Kyiv").
  • countryCode (required) — 2-letter ISO country code for the birth city if location type is 'city' (e.g., US, GB, UA).
  • latitude (required) — Geographic latitude of birth location in decimal degrees (-90 to 90, positive=North) if location type is 'coordinates'.
  • longitude (required) — Geographic longitude of birth location in decimal degrees (-180 to 180, positive=East) if location type is 'coordinates'.
  • starPresets (required) — Select groups of fixed stars to include in analysis, such as Essential (10 stars), Traditional (13 stars), Behenian (15 stars), or Extended (20+ stars).
  • conjunctionOrb — Maximum orb in degrees (0.5-5.0) for conjunction aspects between fixed stars and birth chart points.
  • oppositionOrb — Maximum orb in degrees (0.5-3.0) for opposition aspects between fixed stars and birth chart points.
  • includeStarInterpretations — Toggle to include textual interpretations for star placements in the report.
  • simplify — Toggle to simplify the output providing only key data; disable to return full API response with all metadata.

Output shape

a JSON object containing the fixed stars report data as returned by the astrology API

The report includes astrological data derived from the subject's precise birth date, time, and location; star presets selected; conjunction and opposition orbs settings; and optionally textual interpretations. The 'simplify' option controls whether the response is a simplified summary or detailed full metadata. Error information may be returned if input data is invalid or missing.

Examples

Example 1: Generate a fixed stars astrology report for a person born in London in 1990 including interpretations.

Set subjectName to 'John Doe', birth date fields to 1990-06-15 at 14:30, locationType to 'city', city to 'London', countryCode to 'GB', choose the 'Essential' stars preset, set conjunctionOrb to 2 degrees, oppositionOrb to 1.5 degrees, includeStarInterpretations enabled, simplify enabled.

Links

Discussion