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.
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.
| Field | Type | Required | Description |
|---|---|---|---|
dob | string | ✅ | Date of birth in YYYY-MM-DD format |
gender | string | null | — | 'male' or 'female' — optional; required only for Kua number |
name | string | — | Full name (optional — needed only for name-number) |
system | string | — | Numerology system — 'chaldean' (Vedic/traditional, recommended) or 'pythagorean' (Western) |
{
"dob": "1990-05-15",
"gender": "male",
"name": "Rahul Sharma",
"system": "chaldean"
}
Get a free API key Try it in the playground
/v1/numerology/bhagyank · /v1/numerology/bridge-number · /v1/numerology/business-compatibility · /v1/numerology/career · /v1/numerology/challenge-numbers · /v1/numerology/child