Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Render → Synastry Chart

AI-generated

Summary

Render a synastry (relationship) chart image for two people based on their birth data and location.

Inputs

  • year (required) — Birth year of the first person (4‑digit).
  • month (required) — Birth month of the first person (1‑12).
  • day (required) — Birth day of the first person (1‑31).
  • hour (required) — Birth hour of the first person in 24‑hour format (0‑23).
  • minute (required) — Birth minute of the first person (0‑59).
  • locationType (required) — How to specify the first person's birth location: 'city' (city + country) or 'coordinates' (latitude/longitude).
  • city (required) — Birth city name for the first person (used when locationType is 'city').
  • countryCode (required) — 2‑letter ISO country code for the first person's birth city (used when locationType is 'city').
  • latitude (required) — Geographic latitude of the first person's birth location in decimal degrees (‑90‑90, positive = North) (used when locationType is 'coordinates').
  • longitude (required) — Geographic longitude of the first person's birth location in decimal degrees (‑180‑180, positive = East) (used when locationType is 'coordinates').
  • subject2Name — Optional name for the second person (used in report titles).
  • subject2Year (required) — Birth year of the second person (4‑digit).
  • subject2Month (required) — Birth month of the second person (1‑12).
  • subject2Day (required) — Birth day of the second person (1‑31).
  • subject2Hour (required) — Birth hour of the second person in 24‑hour format (0‑23).
  • subject2Minute (required) — Birth minute of the second person (0‑59).
  • subject2LocationType (required) — How to specify the second person's birth location: 'city' or 'coordinates'.
  • subject2City (required) — Birth city name for the second person (used when subject2LocationType is 'city').
  • subject2CountryCode (required) — 2‑letter ISO country code for the second person's birth city (used when subject2LocationType is 'city').
  • subject2Latitude (required) — Latitude of the second person's birth location in decimal degrees (‑90‑90) (used when subject2LocationType is 'coordinates').
  • subject2Longitude (required) — Longitude of the second person's birth location in decimal degrees (‑180‑180) (used when subject2LocationType is 'coordinates').
  • renderFormat (required) — Output image format for the chart: jpg, pdf, png, svg, or webp.
  • renderTheme (required) — Visual theme for the chart: classic, dark, light, modern_light, or traditional.
  • renderWidth (required) — Width of the output image in pixels (200‑4000).
  • renderHeight (required) — Height of the output image in pixels (200‑4000).
  • backgroundColor (required) — Background color for the chart as a hex color code (e.g., #ffffff).
  • showAspects (required) — Whether to display aspect lines in the chart.
  • showHouseNumbers (required) — Whether to display house numbers in the chart.
  • showDegrees (required) — Whether to display planetary degrees in the chart.

Output shape

object

Contains the rendered chart image in the selected format, typically as a base64‑encoded string (or binary) plus metadata such as format, width, and height. If the chart data is requested without rasterisation, the raw SVG may be returned.

Examples

Example 1: Create a synastry chart for two people born in London and New York.

Set both locationType fields to 'city', provide city names and ISO country codes, fill in birth dates/times, choose SVG format, light theme, 800×800 size, enable aspects, house numbers, and degrees.

Links

Discussion