Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Analysis → Relationship Score

AI-generated

Summary

Calculates a relationship compatibility score between two people based on their birth data and location. Supports various astrological traditions, output languages, and optional inclusion of aspect pattern detection with simplified or detailed responses.

Inputs

  • Year (required) — Birth year of the first person in 4-digit format (e.g., 1990).
  • Month (required) — Birth month of the first person as a number 1-12 (January=1, December=12).
  • Day (required) — Birth day of the month for the first person (1-31).
  • Hour (required) — Birth hour of the first person in 24-hour format (0-23, where 0=midnight, 12=noon).
  • Minute (required) — Birth minute of the first person (0-59).
  • Location Type (required) — Method to specify birth location for the first person: either by city name (auto-detects coordinates) or exact latitude and longitude.
  • City (required) — Birth city name for the first person (e.g., "London") if Location Type is city.
  • Country Code (required) — 2-letter ISO country code for the first person's birth city (e.g., GB) if Location Type is city.
  • Latitude (required) — Geographic latitude of the first person's birth location in decimal degrees (-90 to 90, positive=North) if Location Type is coordinates.
  • Longitude (required) — Geographic longitude of the first person's birth location in decimal degrees (-180 to 180, positive=East) if Location Type is coordinates.
  • Name (Subject 2) — Optional name for the second person (used in report titles).
  • Year (Subject 2) (required) — Birth year of the second person in 4-digit format.
  • Month (Subject 2) (required) — Birth month of the second person as a number 1-12.
  • Day (Subject 2) (required) — Birth day of the month for the second person (1-31).
  • Hour (Subject 2) (required) — Birth hour of the second person in 24-hour format (0-23).
  • Minute (Subject 2) (required) — Birth minute of the second person (0-59).
  • Location Type (Subject 2) (required) — Method to specify birth location for the second person: city name or exact latitude/longitude.
  • City (Subject 2) (required) — Birth city name for the second person if Location Type is city.
  • Country Code (Subject 2) (required) — 2-letter ISO country code for the second person's birth city if Location Type is city.
  • Latitude (Subject 2) (required) — Latitude of the second person's birth location (-90 to 90) if Location Type is coordinates.
  • Longitude (Subject 2) (required) — Longitude of the second person's birth location (-180 to 180) if Location Type is coordinates.
  • Tradition (required) — Astrological tradition to use for the relationship analysis (e.g., Universal, Classical, Psychological, Event Oriented, Vedic, Chinese).
  • Language (required) — Language for response text and interpretations (English, Russian, German, Spanish, French, Italian, Portuguese, Chinese, Japanese, Korean).
  • Include Aspect Patterns — Whether to include aspect pattern detection such as Grand Trine, T-Square, Yod, Stellium, etc. Defaults to false.
  • Simplify — Whether to return a simplified response with key data only; disable to get full API response including all metadata. Defaults to true.

Output shape

a JSON object containing detailed astrological relationship compatibility scores and interpretations between two persons, optionally including aspect patterns. The exact structure may vary depending on options and simplification settings.

Responses respect the selected astrological tradition and language. When 'Simplify' is enabled, the output contains only top-level summary fields. Aspect pattern details are included only if enabled. The operation requires complete birth date/time and location data for both subjects.

Examples

Example 1: Calculate relationship compatibility using birth date/time and city location for both persons with Universal tradition and simplified output.

Specify birth year/month/day/hour/minute and city+country code for person 1 and person 2, select 'Universal' tradition, language as 'English', leave 'Include Aspect Patterns' unchecked, and 'Simplify' checked.

Links

Discussion