SEARCH ASTRO INSIGHT API DOCS
The Numerology Report API provides Numerology related calculations and insights based on Vedic Astrology principles. This endpoint is designed for astrology applications, report generation systems, horoscope platforms, and developer integrations requiring structured JSON responses and reliable REST API access.
https://json.astroinsightapi.com/api/v1/numerology/report
en
hi
Methodology and astrological context for Numerology Report.
Generates a comprehensive, narrative-driven numerology report for an individual based on their full name and date of birth. Unlike the Numerology Table endpoint — which returns raw numerological numbers — this endpoint goes a step further by interpreting those values and delivering a full, human-readable report that explains the meaning and significance of each numerological figure in the context of the individual's life.
This endpoint calculates core numerological values derived from a person's name and birth date, then produces a rich interpretive report that contextualizes each number. The report translates abstract numerological data into meaningful insights about personality, destiny, and life path.
The response includes a detailed numerology report containing:
Life Path Number — The most significant number in numerology, derived from the birth date, revealing the individual's core purpose and life journey.
Destiny / Expression Number — Calculated from the full name, indicating the individual's natural talents, abilities, and life goals.
Soul Urge Number — Reflects the inner desires, motivations, and what the person truly yearns for at a deeper level.
Personality Number — Describes how others perceive the individual based on the outer personality they project.
Birth Day Number — Highlights special talents and characteristics associated with the day of birth.
Interpretive Narratives — For each numerological value, a descriptive explanation is provided, detailing its significance and influence on the individual's life.
Personal Astrology & Numerology Platforms — Power user-facing dashboards that deliver personalized numerology readings.
Horoscope & Spiritual Wellness Apps — Enrich user profiles with deep numerological insights alongside astrological data.
Report Generation Tools — Automatically generate printable or shareable numerology reports for clients or users.
Self-Discovery & Coaching Applications — Provide individuals with meaningful, narrative-based insights to support personal growth and decision-making.
Accepts a person's full name and date of birth (day, month, year) as input.
Computes all major numerological core numbers in a single request.
Returns interpretive, narrative descriptions for each number — not just raw values — making the output immediately consumable by end users without additional processing.
Supports multi-language responses via the Accept-Language header, enabling localized report delivery.
Integrates seamlessly with the broader AstroInsight API ecosystem, complementing astrological chart and compatibility endpoints.
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 Numerology Report.
The Numerology Report API provides authentic 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 Numerology Report 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 Numerology Report consumes 1 API credit. The endpoint delivers high performance with an average response time of ~42ms.
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.