Cycles
Personal year in numerology
Updated
Personal year: how the API works it out
The API reduces the birth month, the birth day and the calendar year to one digit each. To reduce means to add the digits until one digit is left. Then it adds the three and reduces again.
Master numbers are not kept here, so the result is always 1 to 9. The year runs from January 1, not from the birthday. Books differ on that point, and basis.personal_year states the choice.
For John Doe, born August 15, 1990, take the year 2026. The month gives 8, the day 15 gives 6, and 2026 gives 1. So 8 plus 6 plus 1 is 15, and his personal year is 6.
POST /v1/cycles returns it under year, with number, an about line, a reading, do and avoid. The do and avoid texts give plain steps for the year. For a 6 year, the reading is about home, family and duties.
Send as_of to pick the date, or leave it out to use today. The route needs only the birth date, so it suits a daily screen. POST /v1/western returns the same block under personal, beside the other Western numbers.
The personal month and the personal day build on it. With detail=expanded the reading gets longer, while do and avoid keep one length.
Get it from the 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": []
}
}Where the API returns it
| POST | /v1/cycles | Personal year, month and day |
| POST | /v1/western | Western numbers |
| POST | /v1/report | Numerology report (HTML or JSON) |
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.
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