Numerology

Get personal year number

Calculates the personal year number and its guidance for a birth date. Body: date (YYYY-MM-DD), optional year (defaults to the current calendar year). Returns theme, opportunities, challenges, and practical advice.

post/v1/numerology/personal-year

Request

  • Base URL: https://api.asterwise.com
  • URL: https://api.asterwise.com/v1/numerology/personal-year
  • Auth: HTTP bearer

Request body

namestring nullable

Optional and not used in the calculation; accepted so older clients keep working

datestring date required

Birth date (YYYY-MM-DD or ISO datetime string from clients)

yearinteger nullable

Calendar year to interpret; defaults to the current year

Response

Personal year number and yearly guidance

successboolean

True if the request succeeded

messagestring

Human-readable status message

Example response

{
  "data": {
    "year": 2026,
    "personal_year_number": 4,
    "theme": "Structure and discipline",
    "interpretation": "A practical year focused on building strong foundations.",
    "opportunities": [
      "career consolidation",
      "long-term planning"
    ],
    "challenges": [
      "rigidity",
      "slow progress"
    ],
    "advice": "Stay consistent and prioritize sustainable habits."
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.