The Numerology API v1.0.2¶

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.2 current release with 10 new extended endpoint families and full 26-language response coverage
• 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.2 additive release with 10 new direct API endpoint families for relationship milestones, relocation, vehicles, phone-number fit, signatures, pets, creative projects, family legacy, education paths, and travel destination alignment
• 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.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, es, de, fr, pt) 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"

Response Shape (example)¶

{
  "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