New Numerology API

Features

Numerology API features

The numerology API from API for Astrology (apiforastrology.com) has 16 endpoints: 15 in 8 features, plus a health check. Send a name and a birth date to get each number, how it adds up and a short reading. Each feature's page shows a real answer, the rules behind it and its price in reading credits.
Get a free API keyOpen the API reference

Updated

© API for Astrology (apiforastrology.com). "Numerology features explained". All rights reserved. Not to be copied or reused.Two inputs, eight featuresNameBirth dateIndian numerology5Core numbersA=1Name checker#Number checksअBaby namesTwo peopleand time2+2Compatibility2027Personal yearand datesWestern numbersand reports11Western numbersNumerologyreport5A=1#अ2+2202711

Every feature is called the same way

  1. 1Send a name and a birth date as JSON, with your API key in a header.
  2. 2The API adds up the numbers with the rules on the conventions page and finds each one's planet.
  3. 3You get the numbers, how they were worked out and a short reading, in English or Hindi.

POST /v1/profile

# 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"}'

Indian numerology

Two people and time

Western numbers and reports

Which numerology endpoint does each job?

Each numerology job has one endpoint, and all 16 are listed below once, with the reading credits per call. A person’s core numbers come from POST /v1/profile for 3 credits. A full report is POST /v1/report, for 25 credits. Credits count only for a successful call on a live key. Failed calls and test keys use none.

Each numerology job, the endpoint that does it and its credits per call
JobCredits per call
Show a person's core numbers and Lo Shu grid, with its full and empty lines (also called arrows)POST /v1/profile3 credits
Explain one mulank (birth day number) from 1 to 9, with no birth dateGET /v1/guide/{number}3 credits
Check a name and up to 10 other spellings against a personPOST /v1/name1 credit
Suggest spellings that sound the same and suit the person betterPOST /v1/name/suggest1 credit
Check one phone, vehicle or house number, or a business name, against its ownerPOST /v1/number1 credit
Compare up to 5 phone, vehicle or house numbers for one ownerPOST /v1/numbers2 credits
Check a business name against its owner, with new spellings and a launch datePOST /v1/business2 credits
Find baby names whose number suits the child, with their meaningsPOST /v1/baby-names2 credits
Read two people's numbers against each other, both waysPOST /v1/compatibility1 credit
Show a person's personal year, month and dayPOST /v1/cycles2 credits
List the good dates in a month for one personPOST /v1/dates1 credit
Show a calendar year, month by month, for one mulankGET /v1/year/{mulank}2 credits
Show any day's number and how each mulank gets along with itGET /v1/day1 credit
Get the Western numbers, such as the life path, for one personPOST /v1/western3 credits
Make the full numerology report, as printable HTML or JSONPOST /v1/report25 credits
Check that the numerology API is upGET /v1/healthFree

How every numerology feature works

Every feature follows the same rules, so you learn them once. A person’s numbers need only a name and a date of birth, with no birth time or place. The conventions page has the full details. Comparing numerology APIs? See how to choose a numerology API.

  • Chaldean by default

    Names are read in the Chaldean system, the one Indian numerology uses. The Pythagorean number comes back beside it, marked read: false, so you can show both. The Western numbers, such as the life path, use Pythagorean only.

  • Master numbers are flagged

    Master numbers are 11, 22 and 33. The bhagyank (destiny number) and the name numbers always 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.

  • Short or long, same price

    Send detail=standard for short text that fits an app card. Send detail=expanded for text about three times longer. The length never changes the price.

  • English or Hindi

    For readings in another language, send lang=hi for Hindi. Codes and keys stay in English, so your code does not change. Names must be sent in English letters.

  • What the API does not claim

    Numbers describe tendencies, not fixed events. Every reading has a not_claimed line that says so. The API does not rank names or numbers either. It gives each one its fit, and the person chooses.

Numerology API

Try any feature with a free key

Create an account and a test key, then call any endpoint with the sample people. Or try a request in the API reference first.

Get a free API keyOpen the API reference

Your first answer

John Doe, born Aug 15, 1990

POST /v1/profile200 OK
  • Mulank6Venus
  • Bhagyank6Destiny number
  • Name number7Ketu

Real API output. A free test key gets the same answer.

  1. 01

    Test key: 1,000 test calls a month to build with

  2. 02

    Free plan: 2,000 live calls a month, no card needed

  3. 03

    One key: the same key, plan and reading credits as the Astrology API