Marriage Numerology
Describes marriage nature, marital strengths and challenges, compatible and incompatible partner numbers, ideal marriage age range, auspicious years, and qualities to seek in a spouse, derived from Mulank, Bhagyank, and Soul Urge.
Required: dob
Optional: name (enables Soul Urge analysis), gender, system
Returns: Per-number marriage profiles, compatible partner numbers, favourable years, and a bilingual interpretation.
Example request
cURL
curl -X POST https://api.grahaapi.com/v1/numerology/marriage \
-H "Authorization: Bearer sk-test-your-key" \
-H "Content-Type: application/json" \
-d '{
"dob": "1990-05-15",
"gender": "male",
"name": "Rahul Sharma",
"system": "chaldean"
}'Test keys (sk-test-…) are free and unlimited, and return the exact production response structure computed from a fixed sample input. The response is JSON: {"success": true, "data": {…}, "meta": {…}} with Hindi name twins where available (e.g. sign / sign_hi).
Request fields
| Field | Type | Required | Description |
|---|---|---|---|
dob | string | required | Date of birth in YYYY-MM-DD format |
gender | string | null | optional | 'male' or 'female' — optional; required only for Kua number |
name | string | optional | Full name (optional — needed only for name-number) |
system | string | optional | Numerology system — 'chaldean' (Vedic/traditional, recommended) or 'pythagorean' (Western) |
Example body
JSON
{
"dob": "1990-05-15",
"gender": "male",
"name": "Rahul Sharma",
"system": "chaldean"
}