POST/api/astro/porutham/1 credit

Porutham (South Indian matching)

South Indian marriage compatibility: all twelve poruthams from one call. Give both partners' birth star (1-27) and pada (1-4). Each porutham comes back with its traditional result and its South Indian variant side by side. This is a DIFFERENT system from North Indian Ashtakoota gun milan, which /api/astro/gun-milan/ answers. Both read the same two birth stars and disagree about what matters, so pick the one your tradition uses — Tamil, Telugu and Kannada matching use these poruthams. No birth times or places are needed, and that is not a shortcut: porutham is assessed from the nakshatra and its quarter, so a date would be an input the calculation never reads.

https://yogataraapi.prahlad.app/api/astro/porutham/

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	min 1 · max 27
boy_paadham_number	integer	required	min 1 · max 4
girl_nakshatra_number	integer	required	min 1 · max 27
girl_paadham_number	integer	required	min 1 · max 4
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
nakshatra_number	integer	optional
paadha_number	integer	optional
use_astroyogi_method	boolean	optional

Example request

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

Response

{
  "data": {
    "system": "porutham",
    "count": 12,
    "poruthams": [
      {
        "porutham": "varna",
        "traditional": [
          0,
          1
        ],
        "south_indian": null,
        "has_south_variant": false
      },
      {
        "porutham": "vasiya",
        "traditional": [
          1,
          2
        ],
        "south_indian": true,
        "has_south_variant": true
      },
      {
        "porutham": "dina",
        "traditional": [
          3,
          3
        ],
        "south_indian": true,
        "has_south_variant": true
      },
      {
        "porutham": "gana",
        "traditional": [
          6,
          6
        ],
        "south_indian": false,
        "has_south_variant": true
      },
      {
        "porutham": "yoni",
        "traditional": [
          1,
          4
        ],
        "south_indian": true,
        "has_south_variant": true
      },
      {
        "porutham": "raasi_adhipathi",
        "traditional": [
          5,
          5
        ],
        "south_indian": 0,
        "has_south_variant": true
      },
      {
        "porutham": "raasi",
        "traditional": [
          7,
          7
        ],
        "south_indian": true,
        "has_south_variant": true
      },
      {
        "porutham": "naadi",
        "traditional": [
          8,
          8
        ],
        "south_indian": true,
        "has_south_variant": true
      },
      {
        "porutham": "mahendra",
        "traditional": false,
        "south_indian": false,
        "has_south_variant": true
      },
      {
        "porutham": "vedha",
        "traditional": true,
        "south_indian": true,
        "has_south_variant": true
      },
      {
        "porutham": "rajju",
        "traditional": false,
        "south_indian": false,
        "has_south_variant": true
      },
      {
        "porutham": "sthree_dheerga",
        "traditional": true,
        "south_indian": true,
        "has_south_variant": 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.