Numerology API documentation
Updated
The Numerology API docs from API for Astrology (apiforastrology.com) cover all 16 endpoints for Indian and Western numerology. You send a name, a birth date or a number as JSON over HTTPS. You get back the mulank (birth day number), bhagyank (destiny number), name number and Lo Shu grid. Readings come in English or Hindi.
The mulank is also called the driver number, and the bhagyank the conductor number. Other endpoints check names and numbers, match two people, work out the Western numbers and write a full report. Every request goes to https://apiforastrology.com/api/numerology with your API key in a header. The full URL of an endpoint is this base URL plus its path, such as /v1/profile.
Each name comes back in both systems. Chaldean is the one we read, and the Pythagorean numbers sit beside it. The conventions page explains both.
It uses the same API key as the Astrology API. There is no second key and no second plan: numerology calls use reading credits from the same monthly allowance. 16 endpoints, in English and Hindi.
Keys, rate limits and errors work the same way for every API. The docs home covers them and lists the quickstart for each API.
# John Doe, born Aug 15, 1990
curl -X POST "https://apiforastrology.com/api/numerology/v1/profile" \
-H "Authorization: Bearer $ASTROLOGY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"John Doe","birth_date":"1990-08-15"}'- Quickstart: make your first callUse your key to get John Doe's core numbers in a few minutes.
- Authentication and rate limitsSend your key in a header, keep it safe, and know your limits.
- Errors and how to handle themWhat each status code means and what to do about it.
- API referenceEvery endpoint, with examples you can run in the browser.
- ConventionsChaldean and Pythagorean numbers, master numbers, names, dates, language and text length.
- Chaldean vs Pythagorean numerologyBoth letter tables side by side, one real name through each, and what to tell your users.
- ChangelogWhat changed in the API, newest first.
API reference by group
- Meta1 endpoint. Check that the numerology service is up. Free, and no key needed.
- Core numbers3 endpoints. One person's core numbers: the mulank (birth day number), the bhagyank (destiny number) and the name number. Also one number on its own, and the whole reading as a printable report.
- Names3 endpoints. A name and its spellings against a person's numbers, spellings that sound the same and fit better, and baby names whose number suits a child.
- Number checks3 endpoints. A mobile, vehicle or house number, up to 5 numbers side by side, and a business name with its launch date.
- Compatibility1 endpoint. Two people's numbers, read both ways, with a plain outcome.
- Western numbers1 endpoint. The Western (Pythagorean) numbers: life path, expression, soul urge, personality and more.
- Dates and cycles4 endpoints. The personal year, month and day, the good dates in a month, a year for one mulank, and the number of any day.
Postman and OpenAPI
Numerology API
16 endpoints. Import into Postman, Insomnia, Bruno or Hoppscotch, then set apiKey to your key.
https://apiforastrology.com/api/numerology