Papasamyam Details API

The Papasamyam Details API is a Vedic astrology endpoint that performs a Papasamyam (also spelled Papashamya) analysis for two individuals being considered for marriage. Papasamyam is the process of evaluating and balancing the malefic planetary influences (Papa Grahas) present in the horoscopes of both individuals to determine whether their afflictions cancel each other out or create an imbalance.

What This API Does

This API accepts the complete birth details of two individuals — a male and a female — including their date, time, and geographic coordinates of birth. It calculates the positions of malefic planets (such as Mars, Saturn, Rahu, Ketu, the Sun, and the waning Moon) in both horoscopes and evaluates their placement across specific sensitive houses. It then computes the Papasamyam score or status for each individual and determines whether the two horoscopes are compatible from a Papasamyam perspective.

What Data It Returns

The API returns a detailed Papasamyam report that includes:

• Papa (malefic) scores for both the male and female, indicating the total affliction level in each horoscope.

• House-wise malefic planet placements — which malefic planets occupy which sensitive houses in each chart.

• Papasamyam status — whether the two horoscopes are considered balanced (samya) or unbalanced, and whether the match is deemed compatible under this criterion.

• Cancellation factors — any classical exceptions or neutralising conditions that may override or reduce the affliction, such as specific planetary combinations that cancel Mangal Dosha or similar doshas.

Main Use Cases

• Pre-marriage horoscope matching — the primary use case; used by astrologers and matrimonial platforms to check whether a prospective couple's malefic planetary burdens are balanced before recommending a match.

• Mangal Dosha and Dosha compatibility checks — identifying and comparing Mars affliction and other malefic influences as part of a broader compatibility workflow.

• Astrology SaaS and matrimonial platforms — powering automated Papasamyam checks within horoscope matching engines for end users.

• Jyotish (Vedic astrology) software — providing programmatic Papasamyam computation for desktop or web-based astrology applications.

Key Functionality

• Accepts precise birth data (day, month, year, hour, minute, second, latitude, longitude, and timezone offset) for both individuals independently, enabling accurate planetary position calculations for each horoscope.

• Evaluates malefic planet placements across the classical sensitive houses (typically the 1st, 2nd, 4th, 7th, 8th, and 12th houses) as defined in traditional Vedic astrology texts.

• Supports configurable Ayanamsha systems (e.g., Lahiri, Raman, KP) via the X-Ayanamsha header, ensuring compatibility with different schools of Vedic astrology.

• Supports multi-language responses via the Accept-Language header, making it suitable for localised and regional applications.

• Applies classical exception rules to identify cases where doshas are neutralised, providing a nuanced and tradition-aligned result rather than a simple binary output.