The Numerology APIby Dakidarts
 Docs  Start Building
Release History

Changelog

Explore the iterative history of The Numerology API. Every feature shipped, bug crushed, and endpoint expanded — chronologically mapped for full transparency with our developer community.

Latest

v1.0.0 Stellar Intelligence Release

April 12, 2026

Major platform release unifying two big milestones: Extended Numerology rollout and Swiss Ephemeris-powered in-house Horoscope Intelligence. This ships 23 new numerology endpoint families (41 operations), 53+ broad new horoscope report surfaces across periods and sections, production-safe migration behavior, and full docs/smoke parity hardening.

New (15)
  • Added 23 brand new Numerology endpoint families and 41 operations across cycles/timing, identity intelligence, spiritual analysis, and relationship dynamics.
  • Added 53+ new horoscope endpoints across engine-powered report families, section-first period routes, and new astrology report surfaces; combined with Extended Numerology, this release delivers 76+ new endpoints total.
  • Platform release state now stands at 203+ total endpoints, including 130+ horoscope endpoints across reports, charting, and astrology intelligence surfaces.
  • Added cycle expansion endpoints including /api/v1/personal-week, /api/v1/universal-day, /api/v1/universal-week, /api/v1/universal-month, and /api/v1/universal-year.
  • Added Extended numerology intelligence endpoints such as /api/v1/username-numerology, /api/v1/business-name-numerology, /api/v1/brand-name-compare, /api/v1/name-change-impact, and /api/v1/date-alignment-check.
  • Added advanced spiritual endpoints including /api/v1/aura-frequency-reading, /api/v1/chakra-numerology, /api/v1/past-life-patterns, /api/v1/shadow-work-number, and /api/v1/soul-contract-reading.
  • Added relationship-focused endpoints /api/v1/relationship-composite, /api/v1/relationship-healing-reading, and /api/v1/parent-child-numerology.
  • Added GET /api/v1/horoscope/timezones helper for timezone-safe relative-day usage.
  • Added fully periodized planetary report suite under /api/v1/horoscope/reports/planetary/{daily|weekly|monthly|yearly} plus /overview routes.
  • Added full aspects report suite under /api/v1/horoscope/reports/aspects/* for daily/weekly/monthly/yearly sections and overviews.
  • Added full transits report suite under /api/v1/horoscope/reports/transits/* for daily/weekly/monthly/yearly sections and overviews.
  • Added personalized-only house and planet-house report suites under /api/v1/horoscope/reports/house/* and /api/v1/horoscope/reports/planet/house/*.
  • Added new horoscope section route families across periods for communication, friendship, lifestyle, plus split love surfaces love_singles and love_couples.
  • Added yearly section additions for /api/v1/horoscope/reports/health/yearly and /api/v1/horoscope/reports/money/yearly.
  • Added renamed planets informational path GET/POST /api/v1/horoscope/planets-info as canonical replacement for the legacy planets path.
Fixes (11)
  • Upgraded main horoscope report routes to in-house deterministic engine logic: /reports/today, /reports/yesterday, /reports/tomorrow, /reports/weekly, /reports/monthly, and /reports/yearly.
  • Migrated legacy horoscope.com-backed category flows (career/health/love/money families) to engine-backed implementations.
  • Standardized canonical live report namespace to /api/v1/horoscope/reports/* with hidden compatibility aliases for safer migrations.
  • Normalized engine-backed responses to return engine payload plus wrappers: _enterprise and _api_metadata_.
  • Upgraded birthday report parity on POST /api/v1/horoscope/reports/birthday with expanded engine-native request key support and compatibility mapping.
  • Upgraded natal parity on POST /api/v1/birth-chart and POST /api/v1/birth-chart/svg with expanded wheel/config request options and tighter response-shape handling.
  • Improved daily relative-date correctness by applying timezone-aware target-date resolution for today, yesterday, and tomorrow flows.
  • Hardened migration safety: scripts/migrate.py now runs non-destructive update/upsert-style behavior for production-safe upgrades.
  • Completed docs parity refresh with smoke-backed response examples and endpoint table normalization across upgraded numerology + horoscope surfaces.
  • Validated release quality gates with multilingual extended numerology smoke suite at 100% success (en, es, de, fr, pt).
  • Standardized language policy across docs and gateway: engine-backed /horoscope/reports/* routes are currently English-only (lang=en), while multilingual support remains available on supported numerology/helper surfaces.
Deprecated (9)
  • Removed legacy planetary aggregate report route in favor of periodized planetary routes.
  • Deprecated POST /api/v1/horoscope/planetary/overview and replaced with period overview routes under /api/v1/horoscope/reports/planetary/{period}/overview.
  • Kept POST /api/v1/horoscope/planetary/daily/sections only as a hidden alias for backward compatibility.
  • Deprecated alias POST /api/v1/horoscope/love_single/monthly in favor of /api/v1/horoscope/reports/love_singles/monthly.
  • Deprecated and hid POST /api/v1/horoscope/weekly/retail from public docs/OpenAPI.
  • Removed legacy flexible aggregate horoscope route and replaced usage with section-specific and period overview report routes.
  • Removed POST /api/v1/horoscope/yearly/career_money in favor of dedicated yearly career and yearly money routes.
  • Removed active registration for daily combined love paths /api/v1/horoscope/love/{today|tomorrow|yesterday}, replaced by singles/couples split routes.
  • Renamed and removed legacy GET/POST /api/v1/horoscope/planets; use GET/POST /api/v1/horoscope/planets-info.

v0.1.1 The Conscious Expansion Release

January 10, 2026

A deep refinement of the entire system — transforming the API from a numerical calculator into a conscious intelligence engine. All 17+ core numerology endpoints enhanced with themed, content-rich interpretations, plus 5 new premium report endpoints and companion Firefox extension.

New (8)
  • Added /personal-cycle report combining Personal Year and Universal Year cycles for collective timeline context.
  • Added /lifestyle-compatibility report analyzing daily habits, routines, social life, and living dynamics.
  • Added /communication-compatibility report exploring expression styles, listening quality, conflict resolution, and emotional intelligence.
  • Added /growth-evolution-compatibility report examining mutual growth potential and spiritual transformation dynamics.
  • Added /financial-compatibility report analyzing money mindset, risk tolerance, and wealth-building potential.
  • Upgraded all 17+ core numerology endpoints with themed, content-rich interpretations.
  • Released Firefox Extension: Numerology Report Generator Pro for browser-based PDF report generation.
  • Improved caching strategies with LRU + response-level caching for faster response times.
Fixes (3)
  • Fixed minor bugs across multiple endpoints for improved reliability.
  • Improved consistency in metadata and response formatting across all endpoints.
  • Optimized high-frequency endpoint response times for production traffic.
Deprecated (0)

No deprecations in this release.

v0.1.0 The Galactic Blueprint Release

October 29, 2025

First major milestone — crossing 100 endpoints with deeper spiritual analytics. Added 10 advanced numerology tools including birth day numbers, life essence, essence cycles, transits, minor numbers, and bridge numbers for connections between vibrations.

New (10)
  • Added /birth-day-number endpoint returning Birth Day Number and meaning.
  • Added /life-essence combining Life Path + Soul Urge + Expression for unified vibration summary.
  • Added /essence-cycle calculating Essence Cycles and influence patterns across life periods.
  • Added /transits returning letter-based transits derived from name vibrations.
  • Added /minor-personality revealing how short name / nickname shapes external impressions.
  • Added /minor-heart-desire showing inner emotional drives from vowels in short name.
  • Added /minor-expression showing outer expression from full short name vibration.
  • Added /life-expression-bridge bridging Life Path & Expression — purpose meets talents.
  • Added /life-birthday-bridge bridging Life Path & Birth Day — harmonizing goals with gifts.
  • Added /heart-personality-bridge bridging Heart's Desire & Personality — inner emotions meet outer behavior.
Fixes (2)
  • Added unified GET & POST support for every endpoint for maximum flexibility.
  • Enhanced error handling with cleaner, consistent error responses across all endpoints.
Deprecated (0)

No deprecations in this release.

v0.0.9 The Ascension Pathway Release

September 27, 2025

Most comprehensive numerology release yet — local timezone support, compatibility insights, angel synchronicities, and richer detailed meanings across the board. Added 3 brand new endpoints and updated existing ones with timezone awareness.

New (3)
  • Added /personal-hour endpoint with GET/POST support, optional target date, and timezone offset.
  • Added /compatibility-score comparing numerology numbers of two people with individual scores, overall compatibility, and textual insights.
  • Added /angel-number-sync detecting repeated digits and mirrored angel number patterns with synchronicity insights.
Fixes (4)
  • Updated /personal-day with optional timezone offset parameter for user-local accuracy.
  • Updated /personal-month with optional timezone offset for local date alignment.
  • All endpoints now consistently return meaning and expanded detailed_meaning.
  • Improved error handling for invalid dates, timezones, and missing parameters.
Deprecated (0)

No deprecations in this release.

v0.0.8 The Mirror Dimension Release

September 2025

Stepping through the looking glass — mirror-based numerology unlocking hidden balance and reflective cycles between numbers. Reveals how numbers mirror each other, form energetic loops, and guide transformation.

New (2)
  • Added /mirror-numbers endpoint returning Mirror Grid mapping each number to its reflective counterpart with optional expanded mode for detailed meanings and cycles.
  • Added /mirror-path projecting Mirror Path & Cycles from birth date showing number reflections, cycle loops, and karmic insight themes.
Fixes (3)
  • Added expanded analysis mode with cycle tracing for deeper mirror number insights.
  • Unified reduction logic for base numbers respecting master numbers 11, 22, 33.
  • Full error handling with status codes and descriptive error messages across mirror endpoints.
Deprecated (0)

No deprecations in this release.

v0.0.7 The Awakening Release

August 2025

5 brand new endpoints expanding into personal numerology, life cycles, and hidden name patterns. Includes the groundbreaking Hidden Passion Position Number (HPPN) & Gap Resonance discovery by Etuge Anselm E. — expanding the spiritual toolkit to 85 endpoints.

New (5)
  • Added /hidden-passion calculating classic Hidden Passion Number with GET & POST support.
  • Added /maturity-number computing Maturity Number from Life Path + Destiny revealing life purpose evolution theme.
  • Added /hidden-passion-positions calculating HPPN and Gap Resonance with letter positions, sum, reduced HPPN, gap vector, and meanings.
  • Added /pinnacle-cycles breaking life into 4 major long-term cycles with start/end years, number, and detailed meanings.
  • Added /planes-of-expression mapping name letters to Physical, Mental, Emotional, and Intuitive energy planes.
Fixes (3)
  • All new endpoints now handle both GET & POST requests consistently.
  • Improved error handling returning status codes with descriptive error messages.
  • All endpoints return meanings and detailed meanings wherever applicable.
Deprecated (0)

No deprecations in this release.

v0.0.6 The Divine Expansion Release

July 7, 2025

9 transformational endpoints expanding into affirmations, ancestral decoding, and vibrational time tracking — growing the spiritual toolkit from 71 to 80 endpoints. Pricing slashed with boosted request limits across all plans.

New (9)
  • Added /personal-day returning personal day number & meaning based on DOB + date.
  • Added /personal-month returning personal month number & meaning.
  • Added /lucky-days-calendar generating a 9–10 week lucky day calendar.
  • Added /date-meaning reducing any date (YYYY-MM-DD) into numerological meaning.
  • Added /email-numerology decoding numerology energy from an email address.
  • Added /cornerstone-letter getting the first letter of a name and its cornerstone meaning.
  • Added /capstone-letter getting the last letter of a first name and its capstone meaning.
  • Added /ancestor-reading calculating ancestral number & spiritual legacy from family name.
  • Added /personal-day-affirmations delivering Stoic-style daily affirmations based on personal day number.
Fixes (1)
  • Improved pricing structure with reduced costs and boosted request limits across Pro, Ultra, and Mega plans.
Deprecated (0)

No deprecations in this release.

v0.0.5 The Tarot Integration Release

May 2025

Tarot readings arrive — programmable three-card spreads and single-card power pulls for spiritual bots, daily horoscope apps, and magical integrations.

New (2)
  • Added /tarot/reading three-card Tarot spread (past, present, future) with upright/reversed meanings, card images, and optional mode=random or mode=daily.
  • Added /tarot/power single-card power Tarot pull for quick daily insight with same mode parameter support.
Fixes (0)

No fixes in this release.

Deprecated (0)

No deprecations in this release.

v0.0.4 Cosmic Charts & Customization

April 2025

Birth chart generation arrives — both structured JSON and themed SVG image outputs with multi-language support. 2025 horoscope calculations now live.

New (2)
  • Added /birth-chart JSON endpoint returning full natal chart with astrological positions, houses, and planetary aspects.
  • Added /birth-chart/svg generating high-quality SVG natal chart images with 4 themes (light, dark, dark-high-contrast, classic) and 10 language options.
Fixes (1)
  • /horoscope/yearly/* endpoints now include accurate horoscope calculations for 2025 (2026 support coming soon).
Deprecated (0)

No deprecations in this release.

v0.0.3 Mystical Integration

February 2025

Gematria calculator arrives with multiple systems and hidden meaning interpretation. Performance and error handling improvements across the board.

New (1)
  • Added /gematria endpoint computing Gematria values using Ordinal, Reverse Ordinal, Pythagorean, and Standard Hebrew systems with hidden meaning interpretation.
Fixes (2)
  • Optimized API query handling and response times across all endpoints.
  • Enhanced error handling with more detailed messages for invalid inputs.
Deprecated (0)

No deprecations in this release.

v0.0.2 Celestial Expansion

December 13, 2023

Massive expansion adding 12 new astrology endpoints covering zodiac birthdays, compatibility insights, aspects, houses, returns, and planetary effects.

New (12)
  • Added Zodiac Sign Birthday endpoint with unique personality traits per sign.
  • Added Compatibility Career endpoint for astrological career compatibility insights.
  • Added Compatibility Friendship endpoint for friendship dynamics based on signs.
  • Added Compatibility Love endpoint for romantic relationship compatibility.
  • Added Astrology Aspects endpoint exploring aspects and angles between celestial bodies.
  • Added Astrology Houses endpoint uncovering significance of astrological houses.
  • Added Astrology Returns endpoint for Solar Return and Lunar Return insights.
  • Added Astrology Terms endpoint for essential terminology foundation.
  • Added Planets Horoscope endpoint for individual planet influence on horoscopes.
  • Added Planets in Houses endpoint for planetary positions in astrological houses.
  • Added Mercury Retrograde Effect endpoint for communication and technology impact analysis.
  • Added Saturn Returns Effect endpoint for life path and personal growth transformation insights.
Fixes (0)

No fixes in this release.

Deprecated (0)

No deprecations in this release.

v0.0.1 Cosmic Inception

2023

The foundation — 41 initial endpoints covering core numerology calculations, daily/weekly/monthly/yearly horoscopes across love, career, health, and planetary themes, plus zodiac sign analysis endpoints.

New (41)
  • Core numerology: Attitude/Sun, Balance, Challenge, Karmic Debt, Karmic Lessons, Life Period Cycles, Lucky Numbers, Personality, Personal Year, Rational Thought, Soul Expression/Destiny, Soul Urge, Subconscious Self, Phone Number Analysis, Life Path.
  • Horoscopes: Daily (Yesterday/Today/Tomorrow), Weekly, Monthly, Yearly Personal.
  • Love Horoscopes: Daily, Weekly (Couples/Singles), Monthly (Couples/Singles), Yearly Couples, Yearly Singles.
  • Career Horoscopes: Daily, Weekly, Monthly, Yearly.
  • Health Horoscopes: Daily, Weekly, Monthly.
  • Planetary Horoscopes: Daily, Weekly, Monthly.
  • Zodiac endpoints: Sign Personality, Friendship, Love, Lifestyle, Health, Spirituality, Career & Money, Parent & Child.
Fixes (0)

Initial release — baseline launch.

Deprecated (0)

No deprecations in this release.

Changelog FAQs

How often is The Numerology API updated?

We release updates based on community feedback, new endpoint research, and infrastructure improvements. Major releases introduce new numerology modalities and endpoint expansions, while minor patches focus on stability and performance.

How do I get the latest version?

If you're using the API through api.numerologyapi.com, you're always on the latest version — updates are deployed server-side with zero downtime. No client-side changes are needed.

Are older endpoint versions still available?

Yes. We maintain backward compatibility for standard numerology calculations. New interpretations, expanded meanings, and additional endpoints are additive and won't break existing integrations.

How can I contribute a feature request or report a bug?

Open an issue on our GitHub repository or reach out through our contact page. We welcome community input on endpoint behavior and interpretation quality.

What does the version numbering mean?

We follow semantic versioning conventions. Minor version bumps (0.x.0) indicate endpoint additions or structural changes. Patch versions (0.0.x) cover fixes, performance improvements, and interpretation refinements.