THE NUMEROLOGY API · PRODUCTION NODESE 2.10 · <35MS
✦ v1.0.3 is now live ↗
Spiritual intelligence infrastructure
Unlock cosmic intelligence for founders & developers.
Deploy enterprise-grade numerology, astrology & tarot engines. 220+ deterministic endpoints with Swiss Ephemeris accuracy, multi-language support, and sub-35ms response times. No backend math required.
220+
Production endpoints under one unified API key.
26
Production locales across 13 writing systems.
$0.000255
Standard request unit cost on the direct credit model.
Composable intelligence
Enterprise-grade spiritual APIs for modern products.
Advanced numerology, premium horoscope intelligence and tarot-ready divination endpoints ship structured data, deep interpretations and production-ready output quality.
Numerology engine
Deterministic number systems, built as software.
Pythagorean, Chaldean and Vedic numerology power identity, cycles, compatibility, timing, relationships and advanced spiritual analysis.
Advanced Numerology APIsPremium chart rendering
Birth chart visuals designed for products.
Generate presentation-grade natal charts with configurable wheel presets, aspect lines and transparent-background output.
Horoscope intelligence
130+ engine-backed horoscope routes.
Daily, weekly, monthly and yearly report surfaces spanning planets, aspects, transits, houses, compatibility and sign intelligence.
Premium Horoscope APIsTarot
Single-card focus. Three-card story.
Power Tarot and past–present–future spreads return structured symbolic readings for product experiences.
Explore Tarot APIsUnified gateway
One API key. Multiple cosmic engines.
Compose numerology, compatibility, horoscope and tarot modules into a single branded customer experience with predictable response contracts.
GET /api/v1/life_pathPOST /api/v1/birth-chartPOST /api/v1/horoscope/reports/todayGET /api/v1/tarot/reading
Numora Studio · Desktop workspace
The API powers the reading. Studio shapes the experience.
Turn profile-backed numerology and astrology insight into thoughtful, client-ready reports with projects, themes, branding, a local output library and a calm personal observatory.
Profile-backed readingsSingle + batch generationBranded PDF + textLocal-first workflow
My SpacePowered by NumerologyAPI
Production request
No backend math. Just call the engine.
curl_request.shLife Path · Pythagorean · English
curl --request POST \
--url "https://api.numerologyapi.com/api/v1/life_path/post?lang=en" \
--header "X-API-Key: YOUR_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"birth_year": 1997,
"birth_month": 7,
"birth_day": 16,
"num_sys": "pythagorean"
}'Response contract
{ "life_path_number": 3, "system": "pythagorean", "language": "en", "meaning": "...", "_api_metadata_": { "status": "ok" }}
Structured JSON contracts let product teams map response fields once and grow endpoint coverage without rebuilding numerology logic.
Localization
26-language output across the direct API.
Localized outputs are available across the 26 supported languages on api.numerologyapi.com, including engine-backed /horoscope/reports/* routes through on-demand LibreTranslate, Google Translate or DeepL BYOK routing.
Active locale
English
United States · Latin · Left to right
GET /api/v1/life_path?lang=enCoverage
26production locales
GET + POSTquery support
For POST calls, pass lang in the URL query string. Report translation can be selected per request; RapidAPI routing does not expose the same multilingual surface.
Planetary-scale infrastructure
A deterministic core connected to your product edge.
The direct host is designed for burst-heavy production usage, role-based governance and low-latency delivery across real applications.
Multi-region edge mesh
Route requests to the nearest production node.
Direct API infrastructure is positioned for high concurrency and burst traffic, with public trust visibility and production governance.
Swiss Ephemeris precision core
6,000 years of deterministic planetary motion.
Astronomical calculations use Swiss Ephemeris SE 2.10 for high-fidelity planetary coordinates, charting and report generation.
0.0001arcsec precision
<35ms
Edge response performance engineered for latency-sensitive product surfaces.
99.99%
Reliability target backed by public trust visibility and enterprise operations.
3
Numerology systems: Pythagorean, Chaldean and Vedic.
Pay-as-you-go
$1 = 3,921.57
credits. One standard API request consumes one credit at an estimated $0.000255 per request.
Explore PricingCommercial flexibility
Start small. Scale anytime.
01PrototypeUse the same schema and docs.
02LaunchTop up credits as traffic grows.
03EnterpriseMove to private or SLA-backed terms when needed.
FAQ
Frequently asked questions.
Use your API key in the X-API-Key header for every request sent to api.numerologyapi.com.
The direct API now supports 26 languages, including engine-backed horoscope reports through on-demand LibreTranslate, Google Translate, or DeepL BYOK routing. RapidAPI does not expose the same multilingual surface.
Purchase credits in the dashboard and consume them by request. The core conversion is 1 USD = 3,921.57 credits, with one standard request consuming one credit.
Use dashboard.numerologyapi.com for keys, billing and role-based workspaces, and docs.numerologyapi.com for integration guides.
Yes. Begin with low-volume usage, monitor credit burn, then grow into larger packs or enterprise commercial terms as traffic expands.
v1.0.3 adds five zodiac sign families, on-demand report translation, full birth-chart SVG wheel customization, and Numora Studio v0.1.0-beta.
Yes. Use the wheel customization object to control presets, themes, palettes, layout, visibility, typography, planet colors, split output, transparency, and compression.
Yes. Numora Studio v0.1.0-beta is available for macOS, Windows, and Linux, with a dedicated Studio channel and practitioner workspace.
Production keys issued instantly
Ship cosmic intelligence without building the math.
Register, purchase credits and call production endpoints from the same contract you prototyped against.