Solutions

Matrimony

Kundli matching with a score you can explain to a family

The problem

What is actually going wrong

Compatibility scores are the single most scrutinised number in a matrimony product. A score with no breakdown invites distrust, and a score that disagrees with the family astrologer without explaining why loses the customer.

Our approach

Return the guna breakdown alongside the total, computed from sidereal positions rather than a lookup table, so every point in the score is attributable.

Workflow

How the integration runs

  1. Capture

    Birth date, time and place for both profiles.

  2. Chart

    Sidereal birth charts computed under Lahiri ayanamsa.

  3. Match

    Guna Milan across the eight kutas, each scored independently.

  4. Present

    Total plus per-kuta breakdown, with doshas flagged rather than hidden.

Integration

Endpoints and outcomes

Endpoints used

/v1/compatibility/v1/compatibility/score/v1/birth-chart/v1/kundli/teaser

All of these are described in the OpenAPI 3.1 document, so you can generate a typed client rather than hand-writing request code.

What you get

  • Per-kuta breakdown rather than a bare number
  • Consistent with traditional calculation, so it survives a second opinion
  • PDF report generation for sharing with families

Build it this week

The Free plan covers 500 requests a day, which is more than enough to prototype the workflow above.