POST/api/astro/gun-milan/1 credit

Gun milan

Gun milan: the Ashtakoota compatibility score out of 36. This endpoint takes NAKSHATRA AND PADA NUMBERS, not birth dates - `boy_nakshatra_number` and `boy_paadham_number` for one partner, `girl_nakshatra_number` and `girl_paadham_number` for the other. Nakshatras are numbered 1 to 27 from Ashwini and padas 1 to 4. If you have birth details rather than nakshatras, get them from /api/astro/nakshatra/ first. `method` defaults to the North Indian scoring. For the individual kootas behind the total, and the South Indian variants, use /api/astro/ashtakoota/.

https://yogataraapi.prahlad.app/api/astro/gun-milan/

Test Request

Authentication

Send your key in the X-API-Key header. Keys are server-side credentials — never put one in browser JavaScript or a mobile app.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Request fields

Field	Type	Required	Notes
boy_nakshatra_number	integer	required
boy_paadham_number	integer	required
girl_nakshatra_number	integer	required
girl_paadham_number	integer	required
nakshatra_number	integer	required
paadha_number	integer	required
keys	array	optional	Which calculations to return, as a list of names. See the key table for this endpoint; an unrecognised name rejects the whole request. One call costs one credit however many keys you ask for, so request everything you need at once rather than making several calls.
method	string	optional
use_astroyogi_method	boolean	optional

Example request

curl -X POST https://yogataraapi.prahlad.app/api/astro/gun-milan/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"boy_nakshatra_number":5,"boy_paadham_number":2,"girl_nakshatra_number":12,"girl_paadham_number":3,"nakshatra_number":5,"paadha_number":2}'

Response

{
  "data": {
    "score": [
      0,
      0,
      6,
      3,
      1,
      5,
      0,
      8,
      23,
      false,
      true,
      false,
      true
    ]
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Captured from a real call using the exact request above. Results sit under data.

Errors

Metering errors return { "error": "…", "message": "<code>", "is_error": true }. Show error to people and branch on message. See the error reference.