POST · VEDIC

Newborn Report

Endpoint POST https://starsapi.com/api/v3/vedic/predictions/newborn-report

Returns a comprehensive newborn birth report with lagna-based personality profile (8 sections), computed dosha checks (Mangal, Kaal Sarp, Gandmool, Pitra, Grahan), Namakarana (naming syllables from Moon nakshatra), and ascendant/Moon details with Hindi names. Text is personalized with the baby’s name and gender pronouns when provided.

Authentication

MethodExample
Header (recommended)X-Api-Key: am_live_xxxxxxxxxxxx
BearerAuthorization: Bearer am_live_xxxxxxxxxxxx
Query?api_key=am_live_xxxxxxxxxxxx

Request body

FieldTypeRequiredDescription
yearintegerYesBirth year, 1800–2400.
monthintegerYesBirth month, 1–12.
dayintegerYesDay of month.
hourintegerYesHour, 0–23.
minuteintegerYesMinute, 0–59.
secondintegerNoDefault 0.
latitudenumberYesDecimal degrees, −90…90.
longitudenumberYesDecimal degrees, −180…180.
timezonestringYesIANA timezone identifier.
namestringNoBaby’s name. Used in personalized text (replaces “The child”).
genderstringNomale, female, or omit. Controls pronoun substitution (he/she/the child).
ayanamsastringNoDefault lahiri.
node_typestringNomean (default) or true.
languagestringNoDefault en. Supported: en, es, fr, pt, it, de, ru, hi, ta, te, kn, ml, bn.

Response shape

Top-level

FieldTypeDescription
birth_detailsobjectEchoed name, gender, date, time, timezone, coordinates.
ascendantobjectSign, sign_hindi, sign_lord, degree, nakshatra, nakshatra_pada, nakshatra_lord.
moonobjectSame fields as ascendant for the Moon.
namakaranaobjectNaming syllables based on Moon nakshatra pada.
sectionsobject8 keyed personality sections (see below).
doshasobject5 computed dosha checks (see below).

namakarana object

FieldTypeDescription
recommended_syllablestringBest syllable for this pada (English transliteration).
recommended_syllable_histringSame in Devanagari.
all_syllablesarrayAll 4 syllables for this nakshatra (all padas).
all_syllables_hiarrayAll 4 syllables in Devanagari.
based_onstringe.g. "Moon in Ashwini Pada 2".

8 personality sections

Each has title, text (personalized with name/gender), keywords.

KeyTitle
overviewOverview
temperamentTemperament
healthHealth
learningLearning Style
talentsNatural Talents
challengesChallenges
parent_bondParent Bond
favorableFavorable Elements

5 dosha checks

KeyExtra fields when present
mangal_doshapresent, severity, description
kaal_sarp_doshapresent, is_partial, type_name, direction, description
gandmool_nakshatrapresent, nakshatra, pada, severity, remedies, description
pitra_doshapresent, severity, description
grahan_doshapresent, conjunctions, description

Errors

HTTPCodeCause
400MISSING_FIELDRequired field absent.
400INVALID_DATEYear out of range or bad calendar date.
400INVALID_TIMEZONENon-IANA timezone.
400INVALID_COORDINATELatitude or longitude out of range.
400INVALID_PARAMBad node_type, ayanamsa, or language.
405METHOD_NOT_ALLOWEDNon-POST request.
500COMPUTE_ERRORChart computation failed.

Notes

  • When name and gender are provided, all section text is personalized — “The child” is replaced with the name, and pronouns match the gender.
  • Gandmool nakshatras: Ashwini, Ashlesha, Magha, Jyeshtha, Mula, Revati. If the Moon is in one, gandmool_nakshatra.present is true.
  • Namakarana syllables follow the classical Moon-nakshatra-pada mapping from Brihat Parashara Hora Shastra, returned in both English transliteration and Devanagari.
  • All 12 ascendant signs are covered with 8 sections each — 96 unique entries.

See also