SEARCH ASTRO INSIGHT API DOCS
The Personality Number Report API provides Western Numerology related calculations and insights based on Western 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/western/numerology/report/personality-number
en
hi
Methodology and astrological context for Personality Number Report.
The Personality Number Report API generates a detailed, interpretive report centered on an individual's Personality Number — a key element of a Western numerology profile that governs the outer self. Derived from the consonants in a person's full birth name, the Personality Number reveals how an individual is perceived by others, the impression they naturally project, and the social mask or persona they present to the world. Unlike the Soul Urge Number which reflects inner desires, the Personality Number is about the external layer — what others see, sense, and experience when they encounter the individual. This endpoint returns a fully narrative report that brings this outer dimension to life.
The API returns a comprehensive, human-readable report built around the Personality Number, which may include:
Personality Number — The core value calculated by summing the numerological values of all consonants in the full birth name and reducing the result to a single digit or master number (11, 22, 33).
Interpretive narrative — A rich description of the outward persona, social presence, and first-impression qualities associated with the Personality Number.
How others perceive the individual — Insight into the traits, energy, and demeanor that others most readily notice and respond to when interacting with the person.
Social and professional presence — How the Personality Number shapes the individual's communication style, approachability, and the kind of authority or warmth they naturally project in social and professional settings.
Appearance and presentation tendencies — Numerological insight into the aesthetic sensibilities, style preferences, and physical presentation that the individual may naturally gravitate toward.
Alignment between inner and outer self — Guidance on how well the Personality Number harmonizes with the Soul Urge Number, and what it means when the outer persona and inner desires are aligned or in tension.
Relationship and social dynamics — How the Personality Number influences first impressions, social connections, and the types of people and environments the individual tends to attract.
The report is structured for direct presentation to end users and is ready for display without further processing.
Complete numerology profiles — Include the Personality Number as a dedicated section within a full numerological reading to provide a well-rounded picture of both the inner and outer self.
Personal branding and image consulting tools — Help individuals understand the persona they naturally project and how to align it intentionally with their goals and values.
Social and professional networking platforms — Offer users insight into how they come across to others, enabling more conscious and effective self-presentation.
Relationship and compatibility tools — Explore how an individual's outer persona interacts with and complements or contrasts with a partner's personality profile.
Coaching and self-development applications — Support clients in bridging the gap between who they feel they are on the inside and how they are experienced by the outside world.
Accepts a person's full birth name and date of birth (day, month, year) as input; the consonants of the full birth name are the primary driver of the Personality Number calculation.
Returns a fully interpreted, narrative-style report that translates the Personality Number into meaningful, socially and professionally relevant insights.
Correctly handles master numbers (11, 22, 33), preserving their heightened significance rather than reducing them to single digits.
Supports language localization via the Accept-Language header, enabling the report to be delivered in the user's preferred language.
Designed to integrate naturally within the AstroInsight API ecosystem, working in tandem with the Soul Urge, Expression, Life Path, and other numerology report endpoints to deliver a complete inner-and-outer numerological portrait.
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 Personality Number Report.
The Personality Number Report 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 Personality Number 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 Personality Number Report consumes 1 API credit. The endpoint delivers high performance with an average response time of ~58ms.
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.