The Vedika Matrimony API, also called a kundali matching API, scores the compatibility of two birth charts and returns the result as structured JSON: the 36-point Ashtakoota Guna Milan with its per-koota breakdown, South Indian nakshatra porutham, Navamsa (D9) marriage analysis, and bulk matching for matrimony platforms.
It sits inside the Vedika astrology API, so the same key and wallet also give you the birth charts behind each match. Positions are computed by Vedika Ephemeris, Vedika's own astronomical engine (Apache-2.0). If you want to try matching with no key at all, see the free kundali matching API page.
| Endpoint | Returns |
|---|---|
POST /v2/astrology/guna-milan | Guna Milan (Ashtakoot Matching) |
POST /v2/astrology/nakshatra-porutham | Nakshatra Porutham (South Indian Matching) |
POST /v2/astrology/thirumana-porutham | Thirumana Porutham |
POST /v2/matrimony/unified-match | Unified Matrimony Match |
POST /v2/matrimony/north-match | North Indian Matching |
POST /v2/matrimony/south-match | South Indian Matching |
POST /v2/matrimony/compatibility-score | Compatibility Score |
POST /v2/matrimony/d9-analysis | Navamsa Marriage Analysis |
POST /v2/matrimony/mangal-quick | Quick Mangal Check |
POST /v2/matrimony/nadi-check | Nadi Compatibility Check |
POST /v2/matrimony/dosha-cancellation | Dosha Cancellation Analysis |
POST /v2/matrimony/bulk-match | Bulk Matching |
POST /v2/matrimony/pdf-report | Marriage Report PDF |
Several matching routes have aliases such as kundali-matching and ashtakoot-match. The API reference lists every route.
Send the birth datetime, latitude, longitude and timezone for both people. Auth is a Bearer API key. The keyless sandbox mirrors the production routes.
curl -X POST https://api.vedika.io/v2/astrology/guna-milan \
-H "Authorization: Bearer vk_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"male":{"datetime":"1995-06-20T10:30:00","latitude":28.6139,"longitude":77.209,"timezone":"+05:30"},"female":{"datetime":"1997-03-15T14:00:00","latitude":19.076,"longitude":72.8777,"timezone":"+05:30"}}'See the quickstart and the API reference.
Self-serve plans are Starter $12/month, Professional $60/month, Business $120/month and Enterprise $240/month. Flagship is custom-priced by contract. AI answers are priced per query and vary with the request; each response reports the amount charged. There is no free production tier, and the sandbox is a mock. Accounts that have never paid can start one 14-day Professional trial. Terms are on the pricing page.
Use it for matrimony platforms, wedding apps and astrologer tools that need a compatibility score a person can read. North Indian Ashtakoota matching and South Indian porutham are both available, so one integration serves users from either tradition. Matching a single profile against many candidates is a single bulk-match call.
It returns Ashtakoota Guna Milan with the 36-point score and a per-koota breakdown, nakshatra porutham, Navamsa (D9) marriage analysis and bulk matching for matrimony platforms, all as structured JSON.
Yes. The API provides the North Indian Ashtakoota Guna Milan (out of 36) and South Indian nakshatra porutham, so you can serve users across regional matching traditions.
Yes. POST /v2/matrimony/bulk-match takes one primary profile and a list of candidate profiles, so a matrimony platform can score one person against many in a single call.
Matching uses the Moon, nakshatra and Navamsa positions computed by Vedika Ephemeris, Vedika's own astronomical engine (Apache-2.0). Its agreement with NASA JPL DE440 is published per body at vedika.io/benchmarks; that benchmark compares ecliptic longitudes only and does not test matching scores.
Yes. A keyless mock sandbox at vedika.io/sandbox mirrors production routes, so you can call it with no API key. There is no free production tier. Accounts that have never paid can start one 14-day Professional trial: you authorise the Professional auto-debit and receive $5 of credit that ends with the trial. Nothing is charged for the plan on day 0, and Professional ($60/month, plus GST in India) is charged on day 14 unless you cancel at least 48 hours before the trial ends.
Free kundali matching API · Kundali API · Astrology API · Dasha API · Documentation · API reference · Pricing · Playground