Cycles
Universal day in numerology
Updated
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
GET /v1/day
# Oct 1, 2026
curl "https://apiforastrology.com/api/numerology/v1/day?date=2026-10-01" \
-H "Authorization: Bearer $ASTROLOGY_API_KEY"{
"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/day | A day's number |
| POST | /v1/dates | Good dates in a month |
| POST | /v1/business | Business 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
- Mulank6Venus
- Bhagyank6Destiny number
- Name number7Ketu
Real API output. A free test key gets the same answer.
01
Test key: 1,000 test calls a month to build with
02
Free plan: 2,000 live calls a month, no card needed
03
One key: the same key, plan and reading credits as the Astrology API