New Numerology API

Numerology API

Numerology API for mulank, name numbers, life path and the Lo Shu grid

The numerology API from API for Astrology (apiforastrology.com) turns a name and a birth date into numbers. Each number shows how it was added up. It comes with a short reading in English or Hindi. The numbers include the mulank (birth day number, also called the driver number) and the bhagyank (destiny number, also called the conductor number). Indian numerology by default, with the Western numbers beside it.

In one API
16 endpoints
Default system
Chaldean
Readings in
2 languages
With the Astrology API
One key
123456789492357816
POST /v1/profile200 OK
{
  "name": "John Doe",
  "birth_date": "1990-08-15"
}
  • Mulank15 → 1 + 56
  • Bhagyank33 → 3 + 36
  • Name number34 → 3 + 47

Real output for John Doe, born Aug 15, 1990.

Updated

What is a numerology API?

A numerology API is a web service that turns a name and a birth date into numbers. The app sends both as JSON. The service maps letters to numbers and adds up the digits by fixed rules. It sends back each number, how it was added up and a short reading.

What can you build with the Numerology API?

The Numerology API is built for numerology apps, matrimony sites and dating apps. It also suits business naming tools, sellers of mobile numbers and names, and astrologer platforms. Each of these 6 use cases has its own page, with the endpoints that product needs.

How is the Numerology API different from the Astrology API?

The Numerology API needs only a name and a birth date, with no birth time or place. The Astrology API needs the birth date, the time and the place. Numerology answers use reading credits, while astrology calculations use calls. One API key and one plan cover both, with readings in English or Hindi.

Features

What the numerology API covers

16 endpoints: 15 in 8 features, plus a health check. Each one takes a name, a birth date or a number, and answers with JSON.

Your first call

John Doe, born on August 15, 1990. Send his name and birth date with your API key, and the core numbers come back as JSON. Set ASTROLOGY_API_KEY to your key: the same key works for both APIs. The answer here shows the core numbers only. The full answer also has the lucky day, the remedies and the Lo Shu grid. That grid is a 3 by 3 square filled from the birth date. The grid has eight lines, which many books call arrows. The answer lists the lines that are full and the ones that are empty.

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"}'
Response (core numbers only)200 OK
{
  "input": {
    "name": "John Doe",
    "birth_date": "1990-08-15"
  },
  "mulank": {
    "number": 6,
    "planet": "Venus",
    "planet_name": "Venus",
    "about": "Your mulank (birth day number) comes from the day you were born. It shows how you act day to day and how people first see you.",
    "reading": "You care about home, family and things that look good. People feel welcome around you. Watch for spending too much on comfort."
  },
  "bhagyank": {
    "number": 6,
    "total": 33,
    "master": true,
    "planet": "Venus",
    "planet_name": "Venus",
    "about": "Your bhagyank (destiny number) comes from your full birth date. It shows the direction your life tends to take as you grow older.",
    "reading": "Your life tends to center on family, love and responsibility. Work linked to beauty, art, care or comfort often suits this path."
  },
  "name_number": {
    "default_system": "chaldean",
    "chaldean": {
      "system": "chaldean",
      "name": "John Doe",
      "total": 34,
      "compound": 34,
      "number": 7,
      "master": false,
      "words": [
        {
          "word": "John",
          "total": 18,
          "number": 9
        },
        {
          "word": "Doe",
          "total": 16,
          "number": 7
        }
      ],
      "system_name": "Chaldean",
      "planet": "Ketu",
      "planet_name": "Ketu",
      "about": "Your name number comes from the letters of your name. It shows how your name shapes the way people take you.",
      "reading": "Your name gives a quiet, thoughtful feel. People may see you as private or deep."
    },
    "pythagorean": {
      "system": "pythagorean",
      "name": "John Doe",
      "total": 35,
      "compound": 35,
      "number": 8,
      "master": false,
      "words": [
        {
          "word": "John",
          "total": 20,
          "number": 2
        },
        {
          "word": "Doe",
          "total": 15,
          "number": 6
        }
      ],
      "system_name": "Pythagorean",
      "read": false
    }
  }
}

Numbers your users can read

  • Every number comes with its planet and a short reading in plain words. The reading comes in English or Hindi.
  • Each answer shows how the number was added up, so your app can show the working.
  • Codes and keys stay in English in every language, so your code never changes with the language.
  • Short text for app cards by default, or longer text for a full reading, at the same price.
How the numbers are worked out
POST /v1/profile200 OK
{
  "mulank": {
    "number": 6,
    "planet": "Venus",
    "reading": "You care about home, family and things that look good. People feel welcome around you. Watch for spending too much on comfort."
  },
  "bhagyank": {
    "number": 6,
    "total": 33,
    "master": true
  },
  "lucky": {
    "day": "Friday",
    "numbers": {
      "friendly": [
        4,
        5,
        6,
        8
      ]
    }
  },
  "loshu": {
    "missing": [
      {
        "number": 2
      },
      {
        "number": 3
      },
      {
        "number": 4
      }
    ]
  }
}
John Doe's mulank with its planet and a short reading, his bhagyank, and his lucky day and friendly numbers. Real output for John Doe, born Aug 15, 1990.

What it costs

Numerology uses the same plan and the same reading credits as the Astrology API. Each endpoint has one price in credits, in every language and at either length. Test keys are free and answer for the sample people.

Every numerology price
  • Two peoplePOST /v1/compatibility1 credit
  • A day's numberGET /v1/day1 credit
  • Personal year, month and dayPOST /v1/cycles2 credits
  • Core numbers and Lo Shu gridPOST /v1/profile3 credits
  • Numerology report (HTML or JSON)POST /v1/report25 credits

Use cases

Who builds with it

All use cases

Languages

Readings in your users’ language

The Astrology API and the Numerology API answer in English and Hindi today. Names and reading text change with the language. Endpoint paths, codes and error messages stay in English.

  1. Supported

    2 languages

    Works today

    • EnglishDefault
    • हिन्दीHindilang=hi
  2. Coming soon

    2 languages

    Next on the list

    • 中文Chinese
    • EspañolSpanish
  3. Planned

    9 languages

    Not scheduled yet

    • தமிழ்Tamil
    • తెలుగుTelugu
    • 日本語Japanese
    • ಕನ್ನಡKannada
    • FrançaisFrench
    • മലയാളംMalayalam
    • PortuguêsPortuguese
    • РусскийRussian
    • বাংলাBengali

Need a language sooner?Tell us which one. Requests help decide what comes next, and a language in progress gets a target quarter once its schedule is set.

Request a language

Common questions

All questions
What does the Numerology API return?

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.

See all features
Does the API use Chaldean or Pythagorean numerology?

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.

Compare the two systems
Does the Numerology API need a birth time or a birth place?

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.

How dates are read
Which languages do the readings come in?

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.

Read the conventions
Do I need a separate key for the Numerology API?

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.

How to send your key
Can I try the Numerology API for free?

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.

Make your first call

From the blog

Numerology API

Get your first numbers in five minutes

Create an account and a test key, then call any numerology endpoint with the sample people. The same key calls the Astrology API.

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