SEARCH ASTRO INSIGHT API DOCS
The Numerological Numbers API provides western numerology related calculations and insights based on Western Astrology astrology data. This endpoint is designed for horoscope platforms, astrology applications, mobile apps, and developer integrations requiring accurate JSON responses and scalable REST API access.
https://json.astroinsightapi.com/api/v1/western/numerology/numerological-numbers
en
hi
Methodology and astrological context for Numerological Numbers.
The Numerological Numbers API computes a comprehensive set of numerological values derived from a person's full name and date of birth. It applies Western numerology principles to decode the vibrational significance encoded in a person's identity and birth date, returning a structured set of core numbers that form the foundation of a numerological profile.
The API calculates and returns the primary numerological numbers associated with an individual, which typically include:
Life Path Number — Derived from the full date of birth; represents the core life journey, innate traits, and overarching destiny.
Destiny Number (Expression Number) — Calculated from the full name using Pythagorean or similar letter-to-number mapping; reflects the individual's purpose and potential.
Soul Urge Number (Heart's Desire Number) — Derived from the vowels in the full name; reveals inner motivations, desires, and emotional drivers.
Personality Number — Derived from the consonants in the full name; indicates how a person presents themselves to the outside world.
Birthday Number — The raw day of birth, reduced if necessary; highlights a specific talent or gift.
Each number may be returned alongside its reduced form and, where applicable, its master number status (e.g., 11, 22, 33).
Personal numerology reports — Generate detailed numerological profiles for individuals based on their name and birth date.
Astrology and spiritual platforms — Enrich horoscope or birth chart applications with numerological insights as a complementary layer.
Name compatibility and analysis tools — Evaluate the numerological weight of a given name for naming ceremonies, brand naming, or personal rebranding.
Self-discovery and wellness apps — Provide users with introspective data about their personality, life purpose, and inner motivations.
Matchmaking and relationship platforms — Compare numerological profiles between individuals to assess compatibility.
Accepts a person's full name and date of birth (day, month, year) as input.
Applies Western numerology calculation methods to derive all core numbers.
Supports language localization via the Accept-Language header, enabling multi-language response formatting.
Returns a structured JSON response containing all computed numerological values, making it straightforward to integrate into any front-end or downstream service.
Designed to work within the broader AstroInsight API ecosystem, complementing Vedic and Western astrology endpoints with numerological data.
Payload specifications for JSON request body.
| Parameter | Type | Description & Example |
|---|---|---|
|
name
Required
|
string |
Full Name.
Example:
Sanjay
|
|
day
Required
|
integer |
Day of birth (1–31).
Example:
15
|
|
month
Required
|
integer |
Month of birth (1–12).
Example:
9
|
|
year
Required
|
integer |
Year of birth (e.g., 1994).
Example:
1994
|
| Header Key | Value / Format | Description |
|---|---|---|
|
Authorization
Required
|
Basic {base64} |
Base64 encoded string of CLIENT_ID:CLIENT_SECRET. |
|
Content-Type
Required
|
application/json |
Specifies JSON payload format in request body. |
|
Accept-Language
Optional
|
en, hi, ta, te... |
Returns localized astrology output. Default: en |
|
X-Ayanamsha
Optional
|
lahiri, raman, krishnamurti... |
Ayanamsha system: lahiri, raman, fagan_bradley, usha_shashi, krishnamurti, djwhal_khul, yukteshwar, jn_bhasin, suryasiddhanta, aryabhata. Default: lahiri |
Explore complementary endpoints in this category.
Comprehensive developer guidance for Numerological Numbers.
The Numerological Numbers API provides authentic Western Numerology calculations based on Vedic astrology algorithms. It returns structured JSON data containing detailed planetary positions, house calculations, and astrological parameters suitable for Kundli apps, astrology websites, and developer applications.
The Numerological Numbers API requires standard Vedic birth details: day, month, year, hour, min, sec, latitude (lat), longitude (lon), and timezone (tzone). All parameters can be passed in the JSON request body.
Each calculation request to Numerological Numbers consumes 1 API credit. The endpoint delivers high performance with an average response time of ~81ms.
Authenticate using HTTP Basic Authentication by including your Base64 encoded client_id:client_secret credentials in the Authorization header (Authorization: Basic BASE64(client_id:client_secret)).
Yes! The API supports multiple languages including English, Hindi. Pass your desired language code (e.g. 'hi' for Hindi, 'ta' for Tamil, 'en' for English) in the Accept-Language request header.
Supported Ayanamshas include NC Lahiri (Default), BV Raman, Krishnamurti (KP), Fagan Bradley, Usha Shashi, Djwhal Khul, Sri Yukteshwar, JN Bhasin, Surya Siddhanta, and Aryabhata. Specify your choice using the X-Ayanamsha header.
The API returns clean JSON UTF-8 output. Successful requests return HTTP 200 OK with the computed data payload. Parameter validation errors return HTTP 422 with actionable error messages.