Skip to content

The Numerology API v1.0.0

Numerology API Hero

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

  • 203+ documented endpoints across numerology, horoscope, astrology, compatibility, and divination tools
  • v1.0.0 unified release with expanded numerology categories + upgraded horoscope report engine
  • 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.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

Path Best For Auth Notes
RapidAPI (Public) Prototyping, quick tests, smaller public integrations x-rapidapi-key English-first public route
Direct API (api.numerologyapi.com) Advanced integrations, extended numerology categories X-API-Key Required for direct-only endpoint families
Dashboard (dashboard.numerologyapi.com) Key management, private docs, enterprise controls Account login Operational management + enterprise features

Direct-Only Categories

In v1.0.0, these categories are currently available via direct API access only:

  • Identity & Name
  • Spiritual & Shadow
  • Relationship
  • Cycles: Personal Week, Universal Day, Universal Week, Universal Month, Universal Year, Monthly Energy Heatmap, Caution Dates Calendar
  • All Horoscope Report Endpoints

Base URL: https://api.numerologyapi.com

API Reference Map

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

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"

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.0",
    "endpoint_name": "life_path",
    "documentation_url": "https://docs.numerologyapi.com/"
  }
}

Migration Notes for Existing Integrations

  • Route direct-only v1.0.0 categories to https://api.numerologyapi.com.
  • Prefer POST for richer/nested request contracts where available.
  • 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.

Next Steps