Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Insights → Relationship: Compatibility Score

AI-generated

Summary

Calculate a relationship compatibility score between two individuals using their complete birth dates, times, and geographic locations.

Inputs

  • year (required) — Birth year of the first person in 4-digit format (e.g., 1990).
  • month (required) — Birth month of the first person (1-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).
  • minute (required) — Birth minute of the first person (0-59).
  • locationType — Method to specify birth location for the first person: 'city' or 'coordinates'.
  • city (required) — Birth city of the first person (e.g., London, New York).
  • countryCode (required) — 2-letter ISO country code for the first person's birth city (e.g., GB, US).
  • latitude (required) — Latitude of the first person's birth location (-90 to 90 decimal degrees).
  • longitude (required) — Longitude of the first person's birth location (-180 to 180 decimal degrees).
  • subject2Name — Optional name for the second person used in generated report titles.
  • subject2Year (required) — Birth year of the second person in 4-digit format.
  • subject2Month (required) — Birth month of the second person (1-12).
  • subject2Day (required) — Birth day of the month for 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 — Method to specify birth location for the second person: 'city' or 'coordinates'.
  • subject2City (required) — Birth city of the second person.
  • subject2CountryCode (required) — 2-letter ISO country code for the second person's birth city.
  • subject2Latitude (required) — Latitude of the second person's birth location (-90 to 90 decimal degrees).
  • subject2Longitude (required) — Longitude of the second person's birth location (-180 to 180 decimal degrees).
  • language — Language for response text and interpretations (e.g. en, es, fr, de).
  • simplify — Whether to return a simplified response containing key data only.

Output shape

a single record

Returns an object containing relationship compatibility score details and astrological analysis. When simplify is enabled, output fields are limited to top-level key properties.

Examples

Example 1: Calculate relationship compatibility score using city names

Set Subject 1 birth date to 1990-06-15 14:30 in London, GB, and Subject 2 birth date to 1992-08-20 09:15 in New York, US.

Example 2: Calculate relationship compatibility score using exact coordinates

Set locationType and subject2LocationType to 'coordinates', providing latitude and longitude values alongside full birth times for both individuals.

Links

Discussion