HomeAPI DocsNumerology API › Kua Number

Kua Number

POST /v1/numerology/kua-number

**Kua Number (Ba Gua / Feng Shui)** Calculates the Kua (Gua) number from birth year and gender. The Kua number determines auspicious directions for sleeping, working, and facing during important activities, plus the Four Good and Four Bad directions for Feng Shui analysis. **Required:** dob, gender ('male' or 'female') **Optional:** name, system **Returns:** Kua number, group (East/West), four good directions, four bad directions, and bilingual interpretation.

Example request

curl -X POST https://api.grahaapi.com/v1/numerology/kua-number   -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 chart. The response is JSON: {"success": true, "data": {…}, "meta": {…}} with Hindi + English strings, computed on the Lahiri ayanamsa.

Request fields

FieldTypeRequiredDescription
dobstringDate of birth in YYYY-MM-DD format
genderstring | null'male' or 'female' — optional; required only for Kua number
namestringFull name (optional — needed only for name-number)
systemstringNumerology system — 'chaldean' (Vedic/traditional, recommended) or 'pythagorean' (Western)

Example body

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

Get a free API key Try it in the playground

Related Numerology endpoints

/v1/numerology/bhagyank · /v1/numerology/bridge-number · /v1/numerology/business-compatibility · /v1/numerology/career · /v1/numerology/challenge-numbers · /v1/numerology/child