Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Numerology → Compatibility

AI-generated

Summary

Calculates numerology compatibility between two people based on their full names and birth dates.

Inputs

  • subjectName (required) — Full birth 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)
  • subject2Name (required) — Full birth name for the second person
  • subject2Year (required) — Birth year of the second person
  • subject2Month (required) — Birth month of the second person (1-12)
  • subject2Day (required) — Birth day of the second person (1-31)
  • language — Language for response text and interpretations
  • includeInterpretations — Whether to include textual interpretations in the response
  • simplify — Whether to return simplified response with key data only. Disable for full API response with all metadata.

Output shape

object

Returns a numerology compatibility analysis for the two subjects, including each subject's core numbers (Life Path, Expression, Soul Urge, etc.), compatibility scores, and optional textual interpretations. If the simplify option is true, only key fields are returned; otherwise, the full API response with all metadata is included.

Examples

Example 1: Check compatibility between two partners

Set both subjects' names and birth dates, leave language as English (default), keep includeInterpretations and simplify enabled for a concise, readable result.

Links

Discussion