New Numerology API

Basics

Number planets in numerology

Number planets are the ruling planets of the numbers 1 to 9 in Indian numerology. The order is 1 Sun, 2 Moon, 3 Jupiter, 4 Rahu, 5 Mercury, 6 Venus, 7 Ketu, 8 Saturn and 9 Mars. The planet sets a number's nature and how it gets along with other numbers.

Updated

More terms in Basics

© API for Astrology (apiforastrology.com). "Number planets explained". All rights reserved. Not to be copied or reused.Number planets: a planet for each numberChaldean (Indian)1AIJQY2BKR3CGLS4DMT5EHNX6UVW7OZ8FPNo letter is 9Pythagorean (Western)1AJS2BKT3CLU4DMV5ENW6FOX7GPY8HQZ9IRAlphabet order, then start againEach number from 1 to 9 has a ruling planet1Sun2Moon3Jupiter4Rahu5Mercury6Venus7Ketu8Saturn9Mars

Number planets: how the API works it out

The API uses the ank jyotish order. It runs 1 Sun, 2 Moon, 3 Jupiter, 4 Rahu, 5 Mercury, 6 Venus, 7 Ketu, 8 Saturn and 9 Mars. Rahu and Ketu count as planets here, as they do in Indian astrology.

This is not the usual planet order, so a lookup by position goes wrong. Map by name. Every number in a response carries its planet.

The code in planet stays in English, and planet_name holds the word in the reader's language. John Doe's mulank (birth day number) is 6 and comes back with Venus. His name number is 7 and comes back with Ketu.

The planet decides how two numbers get along. The API uses the classical natural friendship of the planets, and that friendship can be one-sided. Mars counts the Moon as a friend, but the Moon counts Mars as neutral.

So any answer that compares two numbers returns both directions. Rahu and Ketu have no place in the classical table. The API reads Rahu as Saturn and Ketu as Mars, and it says so in via.

The planet of the mulank also sets the lucky day, the colors and the remedies. GET /v1/guide/{number} returns one number with its planet and all of these, with no birth date. The printed report takes its cover color from the mulank's planet.

Get it from the API

One number as a mulank. Here is the call to the Numerology API from API for Astrology (apiforastrology.com) for our sample, Mulank 6, John Doe's number.

GET /v1/guide/6

# Mulank 6, John Doe's number
curl "https://apiforastrology.com/api/numerology/v1/guide/6" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY"
Answer (long lists shortened)200 OK
{
  "number": 6,
  "planet": "Venus",
  "planet_name": "Venus",
  "born_on": [
    6,
    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.",
    "topics": [
      {
        "facet": "nature",
        "title": "Nature",
        "text": "Mulank 6 is ruled by Venus. You care about home, family and things that look good. People feel welcome around you, and you often keep peace in a group. You…"
      },
      {
        "facet": "career",
        "title": "Career",
        "text": "You tend to work best in a pleasant place where you can make things better for people. You often have taste and a gift for making people feel at ease. Harsh or…"
      }
    ]
  },
  "bhagyank": {
    "number": 6,
    "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.",
    "topics": [
      {
        "facet": "nature",
        "title": "Nature",
        "text": "With Venus behind your bhagyank, care for family and a love of beauty tend to grow with age. You often become the one who brings people together and makes a…"
      },
      {
        "facet": "career",
        "title": "Career",
        "text": "Your path tends to grow around beauty, care and comfort. You often do well in work that makes people's lives nicer or easier. Fields that tend to suit you…"
      }
    ]
  },
  "name": {
    "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 feels warm and pleasant. People may connect it with charm and good taste."
  },
  "lucky": {
    "from": "mulank",
    "planet": "Venus",
    "planet_name": "Venus",
    "day": "Friday",
    "day_name": "Friday",
    "day_via": null,
    "colors": [
      {
        "color": "white",
        "name": "white"
      },
      {
        "color": "pastel pink",
        "name": "pastel pink"
      }
    ],
    "numbers": {
      "friendly": [
        4,
        5
      ],
      "neutral": [
        3,
        7
      ],
      "unfriendly": [
        1,
        2
      ]
    },
    "dates": [
      4,
      5
    ],
    "dates_about": "Dates of the month that add up to a number friendly to your mulank. They tend to suit starting things."
  },
  "remedies": {
    "from": "mulank",
    "planet": "Venus",
    "planet_name": "Venus",
    "direction": "south-east",
    "direction_name": "South-east",
    "direction_about": "The direction linked to your ruling planet. Facing it for work or study is a common practice.",
    "deity": "Lakshmi",
    "deity_name": "Lakshmi",
    "deity_about": "The deity often worshipped for your ruling planet. Families and regions may follow other customs.",
    "fast_day": "Friday",
    "fast_day_name": "Friday",
    "fast_about": "The weekday of your ruling planet. People who fast for this planet usually keep this day.",
    "gemstone": {
      "stone": "diamond",
      "metal": "silver or platinum",
      "finger": "middle",
      "caution": null,
      "stone_name": "Diamond (heera)",
      "metal_name": "silver or platinum",
      "finger_name": "middle finger",
      "about": "The stone linked to your ruling planet. Numbers alone cannot say whether you should wear it, so check your birth chart with an astrologer first."
    },
    "mantra": {
      "key": "venus:beeja",
      "text": "ॐ द्रां द्रीं द्रौं सः शुक्राय नमः",
      "latin": "Om Draam Dreem Draum Sah Shukraya Namah",
      "audio": "shukra-beej-mantra.mp3",
      "daily": 108,
      "japa": 16000,
      "japa_sources": [],
      "about": "The beej mantra (short seed mantra) of your ruling planet. One round is 108 times. The full count is for a complete practice.",
      "japa_note": null
    }
  },
  "not_claimed": "Numbers describe tendencies, not fixed events. Use them as a guide, not a rule.",
  "localization": {
    "lang": "en",
    "detail": "standard",
    "fell_back_to_en": [],
    "fell_back_to_standard": []
  }
}

Where the API returns it

GET/v1/guide/{number}One number as a mulank
POST/v1/profileCore numbers and Lo Shu grid
POST/v1/compatibilityTwo people

Feature page: Core numbers. The rules the API follows are on the conventions page.

Related terms

From the blog

Numerology API

Get these numbers from the API

Create a free test key and call any route on this page with the sample people. Or try a request in the API reference first.

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