New Numerology API

Cycles

Universal day in numerology

The universal day number is the number a calendar date adds up to. It is the same for everyone, so it needs no birth date. Every digit of the date is added down to one digit. October 1, 2026 gives 3, ruled by Jupiter, which the API then reads for each of the nine mulanks.

Updated

More terms in Cycles

© API for Astrology (apiforastrology.com). "Universal day explained". All rights reserved. Not to be copied or reused.Universal day: a date's own numberPersonal, for John DoeYear 6Month 7Day 8Universal, for everyoneYear 1Day 3Every digit of Oct 1, 2026001111002200226612333 is ruled by JupiterThe same for everyone on that date

Universal day: how the API works it out

The API adds every digit of the date and reduces the sum. To reduce means to add the digits until one digit is left. Take October 1, 2026.

The day gives 1, the month 10 gives 1, and 2026 gives 10. That makes 12, and 1 plus 2 gives 3, ruled by Jupiter. GET /v1/day returns the number, its planet and a theme for the date.

For a 3 day, the theme is good for meeting people and sharing ideas. The mulanks list then reads the date for all nine mulanks (birth day numbers) at once. Each item gives the mulank, its planet, the relation, the outcome and a one-line reading.

On October 1, 2026, mulank 1 comes back good, because the Sun counts Jupiter as a friend. Mulank 2 comes back neutral, because the Moon counts Jupiter as neutral. Send the date query as YYYY-MM-DD, or leave it out for today.

The route needs no birth date, so it suits a daily number page. The same date number appears in other routes. POST /v1/dates reads every date of a month against one person's mulank and bhagyank (destiny number).

POST /v1/business reads a launch date the same way. For a theme tied to one person, use the personal day from POST /v1/cycles instead.

Get it from the API

A day's number. Here is the call to the Numerology API from API for Astrology (apiforastrology.com) for our sample, Oct 1, 2026.

GET /v1/day

# Oct 1, 2026
curl "https://apiforastrology.com/api/numerology/v1/day?date=2026-10-01" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY"
Answer (long lists shortened)200 OK
{
  "date": "2026-10-01",
  "number": 3,
  "planet": "Jupiter",
  "planet_name": "Jupiter",
  "about": "Every date adds up to one number, the same for everyone. How your mulank gets along with today's number shows whether the day tends to suit you.",
  "theme": "Good for meeting people and sharing ideas.",
  "mulanks": [
    {
      "mulank": 1,
      "mulank_planet": "Sun",
      "mulank_planet_name": "Sun",
      "relation": "friend",
      "via": [],
      "outcome": "good",
      "relation_name": "friendly",
      "outcome_name": "Good fit",
      "reading": "A good day for you. Use it for things that matter."
    },
    {
      "mulank": 2,
      "mulank_planet": "Moon",
      "mulank_planet_name": "Moon",
      "relation": "neutral",
      "via": [],
      "outcome": "neutral",
      "relation_name": "neutral",
      "outcome_name": "Neutral",
      "reading": "An ordinary day for you. Keep to your plans."
    }
  ],
  "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/dayA day's number
POST/v1/datesGood dates in a month
POST/v1/businessBusiness name and launch date

Feature page: Personal year and dates. The rules the API follows are on the conventions page.

Related terms

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