Actions231
- Analysis Actions
- Career Analysis
- Compatibility
- Compatibility Score
- Composite Report
- Direction Report
- Health Analysis
- Karmic Analysis
- Lunar Analysis
- Lunar Return Report
- Lunar Return Transit Report
- Natal Report
- Natal Transit Report
- Predictive Analysis
- Progression Report
- Psychological Profile
- Relationship Analysis
- Relationship Score
- Relocation Analysis
- Solar Return Report
- Solar Return Transit Report
- Spiritual Analysis
- Synastry Report
- Transit Report
- Vocational Analysis
- Astrocartography Actions
- Chart Actions
- Chinese Actions
- Data Actions
- Eclipses Actions
- Enhanced Actions
- Fengshui Actions
- Fixed Stars Actions
- Glossary Actions
- Horary Actions
- Horoscope Actions
- Human Design Actions
- Insights Actions
- Business: Department Compatibility
- Business: Hiring Compatibility
- Business: Leadership Style
- Business: Succession Planning
- Business: Team Dynamics
- Business: Timing
- Discover Insights
- Discover Relationship Insights
- Financial: Bradley Siderograph
- Financial: Crypto Timing
- Financial: Forex Timing
- Financial: Gann Analysis
- Financial: Market Timing
- Financial: Personal Trading
- Pet: Compatibility
- Pet: Health Sensitivities
- Pet: Multi-Pet Dynamics
- Pet: Personality
- Pet: Training Windows
- Relationship: Compatibility
- Relationship: Compatibility Score
- Relationship: Davison Chart
- Relationship: Love Languages
- Relationship: Red/Green Flags
- Relationship: Timing
- Wellness: Biorhythms
- Wellness: Body Mapping
- Wellness: Energy Patterns
- Wellness: Moon Calendar
- Wellness: Score
- Wellness: Timing
- Kabbalah Actions
- Lunar Actions
- Numerology Actions
- PDF Actions
- Render Actions
- Tarot Actions
- Analysis - Birth Cards
- Analysis - Dignities
- Analysis - Natal Report
- Analysis - Optimal Times
- Analysis - Quintessence
- Analysis - Timing
- Analysis - Transit Report
- Daily Card
- Draw Cards
- Glossary - Card Detail
- Glossary - Cards
- Glossary - Spreads
- Report - Celtic Cross
- Report - Houses
- Report - Single Card
- Report - Synastry
- Report - Three Card
- Report - Tree of Life
- Search Cards
- Traditional Actions
- Vedic Actions
- Ziwei Actions
Analysis → Relationship Score
AI-generatedSummary
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.