Numerology API FAQ

Indian and Western numerology from a name and a date of birth. It returns the mulank (birth day number), the bhagyank (destiny number) and the name number. The Lo Shu grid comes with them, a 3 by 3 square filled from the birth date. Other routes check names, phone, vehicle and house numbers and business names. They also cover two-person compatibility, the Western numbers, the personal year, baby names and a printable report.

Both, kept apart. Names are read in the Chaldean system by default, which is what Indian numerology uses. The Pythagorean number comes back beside it, labelled, but it is not read. The Western numbers, such as the life path, use Pythagorean only.

No. A person's numbers come from the calendar date of birth, with no time of day and no place. The mulank uses the date as it is, not a day that starts at sunrise.

English and Hindi. Send lang=hi for Hindi. Codes such as planet and outcome stay in English. The words in the reader's language sit beside them in *_name fields. The names you send must still be in English letters.

Yes. Every route takes detail. Send standard for short text that fits an app card, or expanded for text about three times longer. The report uses expanded unless you send standard. The length never changes the price.

Yes. POST /v1/report returns the whole reading as one HTML page that fetches nothing and prints to A4. Send format=json for the same chapters as data, to lay out yourself. Send brand to print your app or company name at the top of the cover.

The Numerology API is one of two APIs from API for Astrology (apiforastrology.com). The other is the Astrology API. One account, one key and one plan call both, and both use the same monthly reading credits. The Numerology API reads Indian (Chaldean) and Western (Pythagorean) numbers from a name and a birth date.

The Numerology API has 16 endpoints in 8 features, from the core numbers to a printable report. The health check is free, and every other route is a written reading paid for with reading credits. With the Astrology API's 65 endpoints, one API for Astrology key reaches 81 endpoints in all.

Sign up with your email, confirm it and create a test key. The same key also calls the Astrology API. Test keys are free and answer for the sample people, John Doe and Jane Doe. For real people, the Free plan gives 150 reading credits a month, with no card needed. Start with POST /v1/profile.

By rules, not AI. The API turns the name's letters into numbers with the Chaldean table from Cheiro's Book of Numbers (1926). It also adds up the digits of the birth date. Fixed rules then pick each reading from a library of text written ahead of time. The same inputs always get the same words, in every language.

The Numerology API reads a birth date as a plain calendar date in YYYY-MM-DD form. It needs no time of day, no place and no planet positions. So it is not tied to the Astrology API's 1850 to 2149 range. Routes about a time, such as the personal year, take as_of, month or year, and default to today.

The mulank (birth day number) adds the digits of the day of birth until one is left. The 15th gives 1 + 5 = 6. The bhagyank (destiny number) adds every digit of the full date. John Doe, born August 15, 1990, has a total of 33. So his bhagyank is 6, with master set to true.

Yes. Many apps call the mulank the driver number and the bhagyank the conductor number. POST /v1/profile returns both.

Each number from 1 to 9 has a ruling planet. The API asks whether the planets of the person's mulank and bhagyank count the number's planet as a friend. A friend and no enemy is good, and an enemy and no friend is difficult. One of each is mixed, and neither is neutral.

No. Names must be in English letters (A to Z), with spaces, dots, hyphens and apostrophes allowed. A name in another script is refused with a 422 error. The API does not change it into English letters for you, because each spelling gives a different number.

No. Spellings, suggestions, baby names and numbers come back in a fixed order, and the answer says ranked: false. The API gives each one its fit, and the choice stays with the person.

All the digits are added until one is left: 212 555 0147 adds up to 32, then 5. Letters in a vehicle or house number are not counted, because books disagree on whether they count. The answer lists them in ignored_letters.

Compound numbers (10 to 52) come back in compound, but they are not read. Master numbers are 11, 22 and 33. The bhagyank and the name numbers end on one digit. They set master to true when the sum passes through a master number. The Western numbers keep the master number itself in number.

No. Every reading carries a not_claimed line saying that numbers describe tendencies, not fixed events. Karmic debt and karmic lessons are read as patterns to work on, not as a claim about a past life.

No. One key works for the Astrology API and the Numerology API. Send it the same way, to the numerology base URL https://apiforastrology.com/api/numerology, with paths such as POST /v1/profile.

Every route but the health check uses reading credits on live keys, never calls. Most cost 1 to 3 credits, and the full report costs 25, the same as the astrology full report. The language and the length never change the price.

Yes. Your plan's reading credits are one monthly pool for all your live keys, and both APIs use it. The credits reset on the 1st of each month (UTC).

Yes. Test keys are free and answer for the sample people in the docs. These are John Doe, born August 15, 1990, and Jane Doe, born March 22, 1992. They work for today or the dates in the docs, and each test call counts as 1 test call. For real people, the Free plan includes 150 reading credits a month.

No. Only a successful live call uses credits, and the credits held for a failed one are given back. The X-Reading-Credits-Counted header shows what a call used, and X-Reading-Credits-Remaining shows what is left this month.

The API answers with a 429 error and the code reading_credits_exceeded until the credits reset on the 1st (UTC). The per-minute limit is separate, and every call counts as 1 toward it, a report too.