Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Vedic → Kundli Matching

AI-generated

Summary

Generate Vedic Kundli matching report comparing two natal charts for compatibility

Inputs

  • 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)
  • hour (required) — Birth hour in 24-hour format (0-23, where 0=midnight, 12=noon)
  • minute (required) — Birth minute (0-59)
  • subject2Year (required) — Birth year of the second person (e.g., 1990)
  • 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)
  • locationType (required) — Choose how to specify birth location: by city name (auto-detects coordinates) or exact latitude/longitude
  • city (required) — Birth city name (e.g., 'London', 'New York', 'Kyiv')
  • countryCode (required) — 2-letter ISO country code for the birth city (e.g., US, GB, UA, DE, FR)
  • subject2City (required) — Birth city of the second person
  • subject2CountryCode (required) — 2-letter ISO country code for the second person's birth city
  • latitude (required) — Geographic latitude of birth location in decimal degrees (-90 to 90, positive=North)
  • longitude (required) — Geographic longitude of birth location in decimal degrees (-180 to 180, positive=East)
  • subject2Latitude (required) — Latitude of the second person's birth location (-90 to 90)
  • subject2Longitude (required) — Longitude of the second person's birth location (-180 to 180)
  • ayanamsa — Ayanamsa (precession correction) system for Vedic calculations (default: lahari)
  • nodeType — Calculation method for lunar nodes (Rahu/Ketu): mean (average position) or true (astronomical position)
  • precision — Decimal precision for degree calculations (0-6, default: 2)
  • simplify — Whether to return simplified response with key data only. Disable for full API response with all metadata.
  • subject2Name — Optional name for the second person (used in report titles)

Output shape

Kundli matching report containing compatibility analysis, guna milan scores, degree calculations, and optional full or simplified API response metadata based on the 'simplify' parameter.

All input fields are validated for ranges (e.g., month 1-12, day 1-31, hour 0-23, minute 0-59, latitude -90 to 90, longitude -180 to 180). Two-subject operations require both sets of birth data and location parameters. The 'simplify' flag controls whether the API response is trimmed to top-level key data (default) or returned in full.

Examples

Example 1: Full Kundli matching report with default simplify=true returns condensed key-data view of compatibility metrics.

Disable simplify to receive complete API metadata including planetary positions, dashas, and detailed interpretive notes.

Links

Discussion