New Numerology API

Name and number checks

Launch date in numerology

A launch date is the day a business or product opens. Numerology adds every digit of that date down to one digit. It then reads that number against the owner's mulank (birth day number) and bhagyank (destiny number). December 12, 2026 adds up to 16, which gives 7.

Updated

More terms in Name and number checks

© API for Astrology (apiforastrology.com). "Launch date explained". All rights reserved. Not to be copied or reused.Launch date: the opening day's numberNameMobileVehicleHouseBusinessLaunchAcme Inc. opens on Dec 12, 20261122112222002266Every digit of the date is added1677Ruled by KetuFit for John DoeNeutral

Launch date: how the API works it out

POST /v1/business reads a launch date when you send launch_date as YYYY-MM-DD. The API adds every digit of the date and reduces the sum. To reduce means to add the digits until one digit is left.

This is the same date number that GET /v1/day returns, the same for everyone. Then the API reads that number against the owner's mulank (birth day number) and bhagyank (destiny number). It uses the same fit rule as a phone number or a name.

Take Acme Inc., owned by John Doe, with a launch date of December 12, 2026. The date adds up to 16, and 1 plus 6 gives 7, ruled by Ketu. John Doe's two numbers are both 6, ruled by Venus.

Venus counts Ketu, read as Mars, as neutral, so the fit is neutral. The launch block holds date, number, planet, an about line and the fit, with each link and its outcome. To choose a date instead of checking one, call POST /v1/dates with the owner's birth date.

Send month=2026-12 for December 2026. It reads every date of that month the same way and lists the good ones in good. Each date also carries the owner's personal_day as a theme, which is not judged.

The API reads the number of the date only. It uses no birth time and no planet positions, so it does not pick an hour.

Get it from the API

Business name and launch date. Here is the call to the Numerology API from API for Astrology (apiforastrology.com) for our sample, Acme Inc., owned by John Doe, born Aug 15, 1990, opening Dec 12, 2026.

POST /v1/business

# Acme Inc., owned by John Doe, born Aug 15, 1990, opening Dec 12, 2026
curl -X POST "https://apiforastrology.com/api/numerology/v1/business" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Acme Inc.","birth_date":"1990-08-15","launch_date":"2026-12-12"}'
Answer (long lists shortened)200 OK
{
  "name": {
    "kind": "business",
    "kind_name": "Business name",
    "about": "A business name is read from its letters, the same way as a person's name.",
    "value": "Acme Inc.",
    "name": "Acme Inc.",
    "total": 22,
    "compound": 22,
    "number": 4,
    "master": true,
    "planet": "Rahu",
    "planet_name": "Rahu",
    "person": {
      "birth_date": "1990-08-15",
      "mulank": 6,
      "bhagyank": 6
    },
    "fit": {
      "number": 4,
      "links": [
        {
          "from": "mulank",
          "from_number": 6,
          "to_number": 4,
          "relation": "friend",
          "via": [
            "Rahu"
          ],
          "from_name": "mulank",
          "relation_name": "friendly"
        },
        {
          "from": "bhagyank",
          "from_number": 6,
          "to_number": 4,
          "relation": "friend",
          "via": [
            "Rahu"
          ],
          "from_name": "bhagyank",
          "relation_name": "friendly"
        }
      ],
      "outcome": "good",
      "outcome_name": "Good fit",
      "reading": "This number gets along well with your own numbers. It tends to support you."
    },
    "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": []
    }
  },
  "suggestions": [
    {
      "name": "Aacme Inc.",
      "word": "Aacme",
      "changes": [
        {
          "code": "double_a",
          "from": "a",
          "to": "aa",
          "at": 0,
          "name": "Doubled an a"
        }
      ],
      "total": 23,
      "compound": 23,
      "number": 5,
      "planet": "Mercury",
      "planet_name": "Mercury",
      "fit": {
        "number": 5,
        "links": [
          {
            "from": "mulank",
            "from_number": 6,
            "to_number": 5,
            "relation": "friend",
            "via": [],
            "from_name": "mulank",
            "relation_name": "friendly"
          },
          {
            "from": "bhagyank",
            "from_number": 6,
            "to_number": 5,
            "relation": "friend",
            "via": [],
            "from_name": "bhagyank",
            "relation_name": "friendly"
          }
        ],
        "outcome": "good",
        "outcome_name": "Good fit",
        "reading": "This number gets along well with your own numbers. It tends to support you."
      }
    }
  ],
  "found": 1,
  "suggest_about": "These spellings sound the same as your name but add up to a number that suits you. Only small, common spelling changes are tried.",
  "not_claimed_spelling": "A new spelling changes the number of the name, not the person. Choose one only if you are happy to use it every day.",
  "launch": {
    "date": "2026-12-12",
    "number": 7,
    "planet": "Ketu",
    "planet_name": "Ketu",
    "fit": {
      "number": 7,
      "links": [
        {
          "from": "mulank",
          "from_number": 6,
          "to_number": 7,
          "relation": "neutral",
          "via": [
            "Ketu"
          ],
          "from_name": "mulank",
          "relation_name": "neutral"
        },
        {
          "from": "bhagyank",
          "from_number": 6,
          "to_number": 7,
          "relation": "neutral",
          "via": [
            "Ketu"
          ],
          "from_name": "bhagyank",
          "relation_name": "neutral"
        }
      ],
      "outcome": "neutral",
      "outcome_name": "Neutral",
      "reading": "This number is neutral to your own numbers. It neither helps nor gets in the way much."
    },
    "about": "A launch date adds up to its own number. It is read against the owner's mulank and bhagyank."
  },
  "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/businessBusiness name and launch date
POST/v1/datesGood dates in a month

Feature page: Number checks. 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