New Numerology API

Core numbers

Friendly numbers in numerology

Friendly numbers are the numbers that get along with a person's mulank (birth day number), because their planets are friends. The other numbers are neutral or unfriendly. Friendship can be one-sided: Mars counts the Moon as a friend, but the Moon counts Mars as neutral. For John Doe, mulank 6, the friendly numbers are 4, 5, 6 and 8.

Updated

More terms in Core numbers

© API for Astrology (apiforastrology.com). "Friendly numbers explained". All rights reserved. Not to be copied or reused.Friendly numbers: who gets alongBirth date, Aug 15, 1990Name (Chaldean values)1155081990J1O7H5N5D4O7E56Mulank 6, ruled by VenusHow 6 gets along with each number123456789friendlyneutralunfriendlyFriendly: 4, 5, 6 and 8

Friendly numbers: how the API works it out

The API keeps no separate table of lucky numbers. It reads friendship from the classical natural friendship of the planets. The planet of the mulank counts each other planet as a friend, as neutral or as an enemy.

A number whose planet is a friend is friendly. The mulank's own number counts as friendly too. Rahu and Ketu are read as Saturn and Mars, and the answer says so in via.

Friendship can be one-sided. Venus counts Mercury as a friend, and Mercury counts Venus as a friend too. But the Moon counts Mars as neutral, while Mars counts the Moon as a friend.

So when two numbers are compared, the API returns both directions. POST /v1/profile returns the lists under lucky.numbers, as friendly, neutral and unfriendly. For John Doe, mulank 6 (Venus), the friendly numbers are 4, 5, 6 and 8.

His neutral ones are 3, 7 and 9, and his unfriendly ones are 1 and 2. GET /v1/guide/{number} returns the same lists for any number from 1 to 9. The same friendship drives every fit in the API.

A name, a phone number or a date is read against both the mulank and the bhagyank (destiny number). The rule has no weights. A friend and no enemy is good, and an enemy and no friend is difficult.

One of each is mixed, and neither is neutral.

Get it from the API

Core numbers and Lo Shu grid. Here is the call to the Numerology API from API for Astrology (apiforastrology.com) for our sample, John Doe, born Aug 15, 1990.

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"}'
Answer (long lists shortened)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.",
    "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,
    "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.",
    "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_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
    }
  },
  "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
    }
  },
  "loshu": {
    "cells": [
      [
        {
          "number": 4,
          "count": 0
        },
        {
          "number": 9,
          "count": 2
        }
      ],
      [
        {
          "number": 3,
          "count": 0
        },
        {
          "number": 5,
          "count": 1
        }
      ]
    ],
    "placed": [
      {
        "number": 1,
        "from": "date",
        "from_name": "birth date"
      },
      {
        "number": 5,
        "from": "date",
        "from_name": "birth date"
      }
    ],
    "missing": [
      {
        "number": 2,
        "reading": "2 is missing. You may not always notice how others feel. Slowing down to listen helps."
      },
      {
        "number": 3,
        "reading": "3 is missing. Planning ahead may not come easily. Writing your plans down can help."
      }
    ],
    "repeated": [
      {
        "number": 1,
        "count": 2,
        "reading": "1 appears more than once. Your self-belief is strong. Too much of it can come across as pride."
      },
      {
        "number": 6,
        "count": 2,
        "reading": "6 appears more than once. You care a lot for home and family. Do not carry everyone's load alone."
      }
    ],
    "planes": [
      {
        "id": "practical",
        "numbers": [
          8,
          1
        ],
        "state": "full",
        "name": "Practical line",
        "reading": "The practical line is full. You tend to be good with hands-on work and money matters."
      },
      {
        "id": "will",
        "numbers": [
          9,
          5
        ],
        "state": "full",
        "name": "Willpower line",
        "reading": "The willpower line is full. Once you decide, you tend to see it through."
      }
    ],
    "basis": "Non-zero digits of the birth date (DD MM YYYY), plus the bhagyank, plus the mulank when the day has two digits. Zero has no cell.",
    "about": "The Lo Shu grid is a 3 by 3 square of the numbers 1 to 9. The digits of your birth date are placed in it. Numbers that are missing or repeated show what comes…",
    "summary": {
      "strong": [
        {
          "from": "number",
          "number": 1,
          "area": "self-belief"
        },
        {
          "from": "number",
          "number": 6,
          "area": "caring for family"
        }
      ],
      "effort": [
        {
          "from": "number",
          "number": 2,
          "area": "noticing how others feel"
        },
        {
          "from": "number",
          "number": 3,
          "area": "planning ahead"
        }
      ],
      "text": "Comes easily to you: self-belief, caring for family, drive, hands-on work and money and seeing things through. Needs more effort: noticing how others feel,…"
    },
    "number_tip": {
      "digits": [
        2,
        3
      ],
      "text": "Many people choose a mobile or vehicle number that has their missing numbers (2, 3, 4 and 7). This is a popular belief, not a promise."
    },
    "birth_only": "Your grid comes only from your birth date. Changing your name does not change it."
  },
  "not_included": {
    "compound_meanings": "The compound number (10 to 52) is returned, but not read: its meanings wait for the astrologer.",
    "western_numbers": "Life path, expression, soul urge, pinnacles, life cycles and the personal year come from the western route."
  },
  "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

POST/v1/profileCore numbers and Lo Shu grid
GET/v1/guide/{number}One number as a mulank
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