New Numerology API

Cycles

Universal year in numerology

The universal year number is the number a calendar year adds up to. It is the same for everyone, so it needs no birth date. The digits of the year are added down to one digit, and master numbers are not kept. So 2026 adds up to 10 and then 1, and 2027 gives 2.

Updated

More terms in Cycles

© API for Astrology (apiforastrology.com). "Universal year explained". All rights reserved. Not to be copied or reused.Universal year: a year's own numberPersonal, for John DoeYear 6Month 7Day 8Universal, for everyoneYear 1Day 3The digits of 2026 added up2 + 0 + 2 + 610111 is ruled by the SunThe same for everyone, so it needs no birth date

Universal year: how the API works it out

The API adds the digits of the year and reduces the sum. To reduce means to add the digits until one digit is left. So 2026 adds up to 10, then 1.

And 2027 adds up to 11, then 2. Master numbers are not kept. GET /v1/year/{mulank} reads a year for one mulank (birth day number).

Pass the mulank, from 1 to 9, in the path. Pass the year in the year query, or leave it out to use this year. The year_number block holds the year's number and its planet.

It also says how the planet of the mulank counts that planet, in relation and outcome. With only one relation to judge, outcome is good, neutral or difficult, never mixed. A short reading for the outcome and a theme for the year's number come with it.

Jane Doe, born March 22, 1992, has mulank 4, ruled by Rahu. For 2026, the year number is 1, ruled by the Sun. Rahu is read as Saturn, and Saturn counts the Sun as an enemy.

So her outcome is difficult, and via names Rahu. The months list reads each month the same way. A month's number is the year's number plus the month, reduced.

For 2026, January is 2 and February is 3. Each month has its number, planet, outcome and a short theme.

Get it from the API

A year for a mulank. Here is the call to the Numerology API from API for Astrology (apiforastrology.com) for our sample, Mulank 4 in 2026.

GET /v1/year/4

# Mulank 4 in 2026
curl "https://apiforastrology.com/api/numerology/v1/year/4?year=2026" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY"
Answer (long lists shortened)200 OK
{
  "mulank": 4,
  "mulank_planet": "Rahu",
  "mulank_planet_name": "Rahu",
  "year": 2026,
  "about": "Every calendar year adds up to one number, the same for everyone. For example, 2027 adds up to 11, then to 2. How your mulank gets along with that number…",
  "year_number": {
    "number": 1,
    "planet": "Sun",
    "planet_name": "Sun",
    "relation": "enemy",
    "via": [
      "Rahu"
    ],
    "outcome": "difficult",
    "relation_name": "unfriendly",
    "outcome_name": "Not a good fit",
    "reading": "Your mulank does not get along easily with this year's number. Things may take more effort or patience. Plan carefully and do not rush big decisions.",
    "theme": "A year that adds up to 1 tends to favor new starts, bold moves and standing on your own."
  },
  "months": [
    {
      "month": 1,
      "month_name": "January",
      "number": 2,
      "planet": "Moon",
      "planet_name": "Moon",
      "outcome": "difficult",
      "outcome_name": "Not a good fit",
      "theme": "Good for teamwork and quiet patience."
    },
    {
      "month": 2,
      "month_name": "February",
      "number": 3,
      "planet": "Jupiter",
      "planet_name": "Jupiter",
      "outcome": "neutral",
      "outcome_name": "Neutral",
      "theme": "Good for meeting people and sharing ideas."
    }
  ],
  "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/year/{mulank}A year for a mulank

Feature page: Personal year and dates. 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.

Get a free API keyOpen the API reference

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