Dates and cycles
Personal Year Number API, Down to the Month and the Day
Updated
How the personal year number API works
- 1Send a birth date, and an as_of date when you want a day other than today.
- 2It adds the birth month and day to the current year, then adds the current month and day.
- 3For John Doe on October 1, 2026, that gives personal year 6, month 7 and day 8.
POST /v1/cycles?as_of=2026-10-01200 OK{
"as_of": "2026-10-01",
"year": {
"number": 6,
"reading": "A year for home, family and duties. People may lean on you."
},
"month": {
"number": 7
},
"day": {
"number": 8
}
}How John Doe's year, month and day add up
These are real answers for John Doe, born August 15, 1990, read on October 1, 2026 (as_of). The last two rows need no birth date.
| Number | How it adds up | Result |
|---|---|---|
| Personal year | Birth month 8 + birth day 15 (1 + 5 = 6) + year 2026 (2 + 0 + 2 + 6 = 10, then 1) = 15, then 6 | 6 |
| Personal month | Personal year 6 + October (10) = 16, then 1 + 6 = 7 | 7 |
| Personal day | Personal month 7 + the 1st = 8 | 8 |
| A good date for John | October 2, 2026: 1 + 0 + 2 + 2 + 0 + 2 + 6 = 13, then 1 + 3 = 4 (Rahu). 4 is a friend of 6, his mulank and bhagyank. | Good |
| Calendar year 2027 for mulank 4 | 2 + 0 + 2 + 7 = 11, then 1 + 1 = 2 (Moon). 2 does not get along with 4. | Difficult |
Every answer ends with the same caution in its not_claimed field: “Numbers describe tendencies, not fixed events. Use them as a guide, not a rule.”
Call the personal year number API from your code
Send the details as JSON with your API key in the Authorization header. Copy the code, set ASTROLOGY_API_KEY to your key, and run it. The same key works for the Astrology API.
POST /v1/cycles
# John Doe, born Aug 15, 1990
curl -X POST "https://apiforastrology.com/api/numerology/v1/cycles?as_of=2026-10-01" \
-H "Authorization: Bearer $ASTROLOGY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"birth_date":"1990-08-15"}'{
"birth_date": "1990-08-15",
"as_of": "2026-10-01",
"year": {
"number": 6,
"about": "Your personal year number shows the theme of this year for you. It changes on January 1.",
"reading": "A year for home, family and duties. People may lean on you.",
"do": "Give time to your home and family. Help the people who lean on you, and plan what you can do for them. Fix or improve something at home. Spend time with your…",
"avoid": "Avoid taking on every duty yourself. Try not to give advice or help where it is not wanted. Do not forget your own rest while you care for others. Avoid…"
},
"month": {
"number": 7,
"about": "Your personal month number shows the theme of this month for you.",
"reading": "This month tends to favor rest, study and thinking things over. You may want more quiet time than usual. It is a good time to read, plan and look inward,…"
},
"day": {
"number": 8,
"about": "Your personal day number shows the theme of this day for you.",
"reading": "Good for work, money and big decisions."
},
"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": []
}
}What the personal year number API returns
- POST /v1/cycles: the personal year, month and day, each with a reading. The year also lists things to do and things to avoid.
- POST /v1/dates: every date of a month read for the person. The good dates are listed in
good. - For each date: its own number, its planet and its
outcome. Apersonal_dayfrom 1 to 9 comes beside it as a theme, not judged. - GET /v1/year/{mulank}: a calendar year read for one mulank, with each of its 12 months.
- GET /v1/day: any date's number, its theme, and how each of the nine mulanks gets along with it.
The year and day routes need no birth date. They suit a page for each mulank, or a daily screen. Leave the date out to read today, this month or this year.
Personal year number API endpoints
POST /v1/cyclesPersonal year, month and dayPOST /v1/datesGood dates in a monthGET /v1/year/{mulank}A year for a mulankGET /v1/dayA day's number
What it uses from your plan
Every numerology answer is a written reading, so it uses reading credits and no calls. The price is the same in every language and at either length. Failed requests are free.
- Personal year, month and day2 credits
- Good dates in a month1 credit
- A year for a mulank2 credits
- A day's number1 credit
The rules behind the personal year number API
The personal year runs on the calendar year and changes on January 1. A good date uses no new rule. Its number gets the same fit test as a phone number. A calendar year adds up to one number for everyone, such as 2027 to 11, then 2. A mulank has one link to that number, so the outcome is good, neutral or difficult, never mixed.
The mulank (birth day number) is the day of birth, added down to one digit. The 1st, 10th, 19th and 28th all give 1, as in Cheiro's Book of Numbers (1926).
Who uses it
- Numerology appsCore numbers at sign-up, a daily number, the personal year and a printable report. A small team can ship a numerology app with it.
- Business naming toolsCheck a business name against its owner. Get spellings that keep the sound and suit the owner better, and a launch date that fits.
- Matrimony and matchmaking sitesA numerology match for every pair of profiles, read both ways from two birth dates. Show it beside the 36-point kundli score.
From the blog
· 12 min read
Date of Birth Numerology: Every Number From the Date Alone
Date of birth numerology for app builders.
Read
· 11 min read
Personal Year Number 2027: How It Is Worked Out
How a personal year number is worked out, with John Doe's 2026 and 2027 sums.
Read
· 9 min read
Numerology App Development: What to Build and What to Buy
Planning a numerology app?
Read
Personal year number API questions
All questionsDoes the personal year change on the birthday?
No. It runs on the calendar year and changes on January 1, for everyone. The about text for the year says so too.
What a personal year isWhich date does each route read?
Today, unless you say otherwise. POST /v1/cycles takes as_of (YYYY-MM-DD), and POST /v1/dates takes month (YYYY-MM). GET /v1/year/{mulank} takes year, and GET /v1/day takes date.
How is a good date picked?
Each date adds up to its own number. That number gets the same fit test as a phone number, against the person's mulank and bhagyank. Dates with a good outcome are listed in the good field. When no date is good, the none field says so.
What favorable dates areCan I show a daily number without a birth date?
Yes. GET /v1/day returns a date's number, its theme, and how each of the nine mulanks gets along with it. It needs no birth date. For a personal day, use POST /v1/cycles.
What a universal day isHow is the year for a mulank different from a personal year?
A personal year comes from a person's birth month and day plus the year. GET /v1/year/{mulank} reads the year's own number, the same for everyone, against one mulank (birth day number). For example, 2027 adds up to 11, then 2.
What a universal year isWhat do the personal year and date routes cost, and can I test them?
On a live key, POST /v1/cycles and GET /v1/year/{mulank} cost 2 reading credits each. POST /v1/dates and GET /v1/day cost 1 each. Test keys answer for the sample people only. They take today or the docs' dates, such as as_of 2026-10-01 and month 2026-10.
See numerology creditsNumerology API
Call it with a free test key
Create an account and a test key, then call any endpoint 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