POST /v1/numerology/personal-year
**Personal Year Number** Calculates the Personal Year number for the current calendar year, which governs the themes, opportunities, and challenges for that 12-month cycle. Also returns the previous and next year's numbers for trend analysis. **Required:** dob **Optional:** name, system **Returns:** Current, previous, and next Personal Year numbers with bilingual themes and advice.
curl -X POST https://api.grahaapi.com/v1/numerology/personal-year -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 chart. The response is JSON: {"success": true, "data": {…}, "meta": {…}} with Hindi + English strings, computed on the Lahiri ayanamsa.
| Field | Type | Required | Description |
|---|---|---|---|
name | string | ✅ | Full name for numerology calculation |
dob | string | ✅ | Date of birth in YYYY-MM-DD format |
system | string | — | Numerology system — 'chaldean' (Vedic/traditional, recommended) or 'pythagorean' (Western) |
{
"dob": "1990-05-15",
"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