Success Number

POST/v1/numerology/success-number

Success Number

The Success Number (Mulank + Bhagyank, reduced) synthesises the two primary Vedic numbers into a single power number that indicates the area of life where peak achievement is most likely. Returns full Vedic detail and bilingual guidance.

Required: dob
Optional: name, system
Returns: Success number, ruling planet, gemstone, auspicious directions, and bilingual achievement themes.

Example request

cURL
curl -X POST https://api.grahaapi.com/v1/numerology/success-number \
  -H "Authorization: Bearer sk-test-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dob": "1990-05-15",
    "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

FieldTypeRequiredDescription
dobstringrequiredDate of birth in YYYY-MM-DD format
namestringoptionalFull name (optional — needed for name-based calculations)
systemstringoptionalNumerology system — 'chaldean' (Vedic/traditional, recommended) or 'pythagorean' (Western)

Example body

JSON
{
  "dob": "1990-05-15",
  "name": "Rahul Sharma",
  "system": "chaldean"
}