The Numerology API v1.0.3¶

The Numerology API is a production-grade platform for building numerology and astrology products with deterministic outputs, structured JSON contracts, and broad endpoint coverage.

• 220+ documented endpoints across numerology, horoscope, astrology, compatibility, travel, education, family legacy, and divination tools
• v1.0.3 current release with zodiac intelligence, full wheel customization, on-demand translation, and Numora Studio
• Public RapidAPI path for fast prototyping and onboarding
• Direct API + dashboard path for advanced and enterprise-grade integration
• Developer-ready docs with request examples, parameter contracts, and response patterns
• v1.0.3 additive release with Zodiac Sun, Moon, Rising, Modality, and Element endpoints plus the v1.0.2 extended endpoint families
• 26 supported response languages: en, fr, es, de, pt, ja, hi, ar, ru, tr, it, pl, nl, id, ko, th, ro, ur, gu, bn, vi, ta, te, mr, pa, zh
• Multi-system numerology support via num_sys: pythagorean, chaldean, and vedic

v1.0.3 Highlights¶

v1.0.3 is a practitioner-focused release for the Numerology API. It adds dedicated zodiac intelligence endpoints, full birth-chart SVG wheel customization, reliable planetary defaults, corrected Birth Day behavior, on-demand translation-provider routing, and Numora Studio v0.1.0-beta for macOS, Windows, and Linux.

• Zodiac intelligence: Sun sign, Moon sign, Rising/Ascendant sign, Modality, and Element endpoints under /api/v1/horoscope/sign/*.
• Planetary reports: planet: "general" is now a valid canonical option and the default where a planetary selection is required.
• Birth Day Number: corrected request validation and detailed meaning resolution while preserving GET/POST parity.
• Birth Chart SVG: full wheel customization through presets, themes, custom palettes, layout, visibility controls, typography, planet colors, split output, and compression options.
• On-demand translations: LibreTranslate by default, Google Translate selection, and DeepL BYOK through X-Translator-Api-Key.
• Numora Studio: v0.1.0-beta desktop distribution for macOS, Windows, and Linux with dedicated Studio API-key routing.
• Response metadata: current responses identify API version 1.0.3 through _api_metadata_.api_version.

→ Read Full v1.0.3 Changelog

v1.0.2 Highlights¶

v1.0.2 is an additive production release for the Numerology API. It builds on the released v1.0.1 multi-system and 8-language milestone by adding 10 more extended endpoint families and expanding supported response coverage to 26 languages.

This release focuses on four major goals:

1. New extended endpoint coverage
2. Adds 10 new endpoint families.
3. Each new endpoint supports both GET and POST.
4. All new endpoints use clean public routes under /api/v1/*.
5. New endpoint families include relationship milestones, relocation, vehicle identity, phone-number fit, signatures, pets, creative projects, family legacy, education paths, and travel destination alignment.

1. Continued multi-system numerology
2. New name/title/text-based endpoints support optional num_sys.
3. Supported systems:
   • pythagorean
   • chaldean
   • vedic

4. pythagorean remains the default to preserve existing behavior.

5. Expanded language coverage

6. v1.0.1 remains the released 8-language milestone:
   • en
   • es
   • de
   • fr
   • pt
   • ar
   • hi
   • ja
7. v1.0.2 adds 18 additional languages:
   • ru
   • tr
   • it
   • pl
   • nl
   • id
   • ko
   • th
   • ro
   • ur
   • gu
   • bn
   • vi
   • ta
   • te
   • mr
   • pa
   • zh

8. The new endpoint families include localized JSON meaning files across all 26 supported language directories.

9. Documentation and release readiness

10. Adds integration docs for all 10 new endpoint families.
11. Adds a v1.0.2 changelog.
12. Updates the Extended Endpoints index and API reference release links.
13. Exposes the new endpoints in dashboard internal docs and command palette discovery.
14. Verifies route visibility, JSON coverage, localized meaning structure, and test-suite stability with Python 3.11.

→ Read Full v1.0.2 Changelog

v1.0.1 Highlights¶

v1.0.1 is an additive production release for the Numerology API. It builds on the v1.0.0 extended numerology rollout by adding deeper name, timing, business, decision, family, team, money, and archetype readings.

This release focuses on four major goals:

1. Broader endpoint coverage
2. Adds 10 new endpoint families.
3. Each new endpoint supports both GET and POST.

4. All new endpoints use clean public routes under /api/v1/*.

5. Multi-system numerology

6. New name-based endpoints support optional num_sys.
7. Supported systems:
   • pythagorean
   • chaldean
   • vedic

8. pythagorean remains the default to preserve existing behavior.

9. Expanded language coverage

10. Supported response languages now include:
    • en
    • es
    • de
    • fr
    • pt
    • ar
    • hi
    • ja

11. The 10 new endpoint families include localized JSON meaning files for all 8 supported languages.

12. Documentation and release readiness

13. Adds integration docs for all 10 new endpoint families.
14. Updates the Extended Endpoints index.
15. Documents GET, POST, lang, and num_sys behavior.
16. Verifies route visibility, JSON coverage, and test-suite stability with Python 3.11.

→ Read Full v1.0.1 Changelog

v1.0.0 Highlights¶

This release combines two major tracks into one platform version:

1. Extended Numerology rollout
2. Added 23 new endpoint families and 41 new GET/POST operations.
3. Added new categories: Identity & Name, Spiritual & Shadow, and Relationship.
4. Expanded timing coverage with personal week and universal day/week/month/year routes.

5. Validated multilingual smoke coverage (en, fr, es, de, pt, ja, hi, ar, ru, tr, it, pl, nl, id, ko, th, ro, ur, gu, bn, vi, ta, te, mr, pa, zh) at 100% in release QA.

6. Horoscope engine migration and expansion

7. Added 53+ new endpoints with standardized canonical report routing under /api/v1/horoscope/reports/*.
8. Expanded daily/weekly/monthly/yearly report families and specialized suites (planetary, aspects, transits, house, planet-house).
9. Upgraded request/response consistency and route parity for production integrations.

→ Read Full v1.0.0 Changelog → Read Horoscope Engine Architecture

Access Paths¶

API Reference Map¶

• API Reference Overview
• Core Endpoints
• Cycles & Transits
• Identity & Name
• Spiritual & Shadow
• Relationship
• Bridge Endpoints
• Karmic Endpoints
• Horoscope Endpoints
• Other Endpoints (Tarot / Gematria)

Horoscope Engine (Production Model)¶

The horoscope stack is deterministic and Swiss Ephemeris-driven, designed for real production behavior (stable outputs, reproducible QA, and cache-friendly route design).

• Deterministic factor stacks by period (daily, weekly, monthly, yearly)
• Public mode (sign-based) and personalized mode (birth-data aware)
• Report suites beyond general horoscope: planetary, aspects, transits, house, planet-house
• Enterprise wrappers in responses (_enterprise, _api_metadata_) for operational metadata

→ Engine Deep Dive → Horoscope Reports Overview

Quick Start¶

Direct API (recommended for advanced coverage)¶

curl "https://api.numerologyapi.com/api/v1/life_path?birth_year=1990&birth_month=5&birth_day=15&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

Direct API v1.0.2 extended endpoint¶

curl "https://api.numerologyapi.com/api/v1/relationship-milestone-numerology?person_a_name=Amina%20Bello&person_a_dob=1992-04-18&person_b_name=Jonas%20Meyer&person_b_dob=1990-11-06&milestone_date=2027-06-12&milestone_type=wedding&num_sys=chaldean&lang=fr" \
  -H "X-API-Key: YOUR_API_KEY"

RapidAPI (public route)¶

curl "https://the-numerology-api.p.rapidapi.com/life_path?birth_year=1990&birth_month=5&birth_day=15" \
  -H "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
  -H "x-rapidapi-host: the-numerology-api.p.rapidapi.com"

{
  "life_path_number": 3,
  "summary": {
    "title": "Life Path 3",
    "overview": "Creative, expressive, and socially magnetic energy pattern."
  },
  "_enterprise": {
    "client": "The Numerology API"
  },
  "_api_metadata_": {
    "api_version": "1.0.2",
    "endpoint_name": "life_path",
    "documentation_url": "https://docs.numerologyapi.com/"
  }
}

Migration Notes for Existing Integrations¶

• Route direct-only v1.0.2 categories to https://api.numerologyapi.com.
• Prefer POST for richer/nested request contracts where available.
• Use lang on supported direct API routes for localized JSON meanings across the 26-language response set.
• Use num_sys on name/title/text-based numerology routes when you need pythagorean, chaldean, or vedic calculations.
• Keep date/month inputs normalized (YYYY-MM-DD, YYYY-MM).
• Parse _enterprise and _api_metadata_ consistently in your client models.
• For horoscope products, move to canonical /api/v1/horoscope/reports/* endpoints.

WordPress Plugin Integration¶

Need a no-code path for site delivery? Use the official Dakidarts Numerology Core plugin to embed forms, readings, and reports directly into WordPress pages.

• Plugin Documentation
• Install from WordPress.org

Next Steps¶

• Getting Started
• Pricing
• Examples
• Changelog
• API Reference