Use case
Baby name API: the name syllable from the birth star
Updated
How it works
- 1New parents enter their baby's birth date, time and place in a baby name app.
- 2The API finds the birth star, the nakshatra the Moon was in, and the quarter (pada) of it.
- 3It returns the traditional name syllable for that quarter, and the app shows names from its own list that start with it.
POST /v1/reading/section/birth-details200 OK{
"birth_details": {
"nakshatra": "Mrigashira",
"pada": 1,
"moon_sign": "Taurus",
"varna": "Vaishya",
"vashya": "Chatushpada",
"yoni": "Serpent",
"gana": "Deva",
"nadi": "Madhya",
"rajju": "Siro",
"naamakshar": "Ve"
}
}How to suggest baby names by nakshatra
Each step is one call, linked to its page in the API reference. Where a card shows values, they are real API output. Planet positions come from NASA JPL planet data (DE440). We check them against NASA JPL Horizons. On 25,571 positions from 1850 to 2149, the Sun and planets agree within 0.001 arc seconds. The Moon agrees within 0.011. An arc second is 1/3,600 of a degree. See how we test accuracy. A practicing astrologer reviews the rules behind these answers. Each rule has an ID in the public rulebook.
- 01
Find the birth star
POST /v1/planetsSend the baby's birth date, local time, place and time zone. The Moon's entry gives its nakshatra and pada (1 to 4), the two facts the syllable comes from.
- positions.1.name
- "Moon"
- positions.1.nakshatra
- "Mrigashira"
- positions.1.pada
- 1
Real output from the example in the API reference.
- 02
Get the name syllable
POST /v1/reading/section/birth-detailsThe naamakshar for the Moon's pada, such as Va for Rohini pada 2. It comes with the Moon sign and the rest of the avakhada chakra (the table of birth facts). Send lang=hi for the syllable in Devanagari.
- birth_details.nakshatra
- "Mrigashira"
- birth_details.pada
- 1
- birth_details.naamakshar
- "Ve"
Real output for John Doe, born Aug 15, 1990, 10:30 AM, New York.
- 03
Explain the birth star
POST /v1/reading/section/nakshatraA plain reading of the birth star, with its ruling planet, deity and symbol, for a "your baby's star" screen.
- blocks.0.nakshatra.name
- "Mrigashira"
- blocks.0.nakshatra.lord
- "Mars"
- blocks.0.nakshatra.devata
- "Soma"
- blocks.0.nakshatra.symbol
- "a deer's head"
Real output for John Doe, born Aug 15, 1990, 10:30 AM, New York.
- 04
Plan the naming day
GET /v1/panchang/dailyFor the naming ceremony: the day's tithi (lunar day), nakshatra, good times and rahu kaal (a time to avoid) in the family's own city.
- date
- "2026-10-01"
- tithi.name
- "Shashthi"
- auspicious.abhijit_muhurta.starts
- "2026-10-01T12:21:46-04:00"
Real output from the example in the API reference.
What you send, what you get, what it costs
| You send | The baby's birth date, local time, place and time zone. Add lang=hi for the syllable in Devanagari. |
|---|---|
| You get | The Moon's nakshatra (birth star) and pada (quarter), the name syllable (naamakshar), a reading of the birth star and the naming day's panchang. |
| It costs | Steps 1 and 4: 1 call each.Steps 2 and 3: 1 reading credit each. |
Costs are for a live key, and failed requests are free. The Free plan includes 2,000 calls and 150 reading credits a month.
Step 1 in code: find the birth star
Send the details as JSON, with your API key in the Authorization header. The other steps work the same way, and each one links to its page in the API reference.
POST /v1/planets
# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/planets" \
-H "Authorization: Bearer $ASTROLOGY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"year":1990,"month":8,"day":15,"hour":10,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'{
"meta": {
"ayanamsa": "lahiri",
"ayanamsa_value": 23.7260727,
"julian_day": 2448119.10483,
"ephemeris": "JPL DE440s",
"node": "true",
"timezone": {
"source": "zone",
"offset_hours": -4,
"zone": "America/New_York",
"abbreviation": "EDT",
"dst": true,
"dst_hours": 1,
"ambiguous_resolved_by_fold": null,
"note": "read from the IANA tz database at this instant, so daylight saving and historical offset changes are included"
}
},
"ascendant": {
"name": "Ascendant",
"longitude": 169.934155,
"sign": "Virgo",
"sign_number": 6,
"degree_in_sign": 19.934155,
"degree_dms": "19 : 56 : 03",
"house": 1,
"nakshatra": "Hast",
"nakshatra_lord": "Moon",
"pada": 3,
"speed": 0,
"retrograde": false,
"combust": false,
"dignity": "n/a",
"vargottama": false,
"pushkara": {
"navamsa": false,
"navamsa_number": 6,
"bhaga": false,
"bhaga_degree": 9,
"bhaga_by_element": false,
"bhaga_degree_by_element": 14,
"sources_agree": true,
"orb_degrees": 1
}
},
"positions": [
{
"name": "Sun",
"longitude": 118.7753409,
"sign": "Cancer",
"sign_number": 4,
"degree_in_sign": 28.7753409,
"degree_dms": "28 : 46 : 31",
"house": 11,
"nakshatra": "Ashlesha",
"nakshatra_lord": "Mercury",
"pada": 4,
"speed": 0.9610665,
"retrograde": false,
"combust": false,
"dignity": "friend",
"vargottama": false,
"pushkara": {
"navamsa": false,
"navamsa_number": 9,
"bhaga": false,
"bhaga_degree": 8,
"bhaga_by_element": false,
"bhaga_degree_by_element": 7,
"sources_agree": true,
"orb_degrees": 1
}
},
{
"name": "Moon",
"longitude": 54.5750352,
"sign": "Taurus",
"sign_number": 2,
"degree_in_sign": 24.5750352,
"degree_dms": "24 : 34 : 30",
"house": 9,
"nakshatra": "Mrigashira",
"nakshatra_lord": "Mars",
"pada": 1,
"speed": 14.258194,
"retrograde": false,
"combust": false,
"dignity": "mulatrikona",
"vargottama": false,
"pushkara": {
"navamsa": false,
"navamsa_number": 8,
"bhaga": false,
"bhaga_degree": 14,
"bhaga_by_element": false,
"bhaga_degree_by_element": 14,
"sources_agree": true,
"orb_degrees": 1
}
},
{
"name": "Mars",
"longitude": 27.7149328,
"sign": "Aries",
"sign_number": 1,
"degree_in_sign": 27.7149328,
"degree_dms": "27 : 42 : 54",
"house": 8,
"nakshatra": "Krittika",
"nakshatra_lord": "Sun",
"pada": 1,
"speed": 0.5753266,
"retrograde": false,
"combust": false,
"dignity": "own sign",
"vargottama": false,
"pushkara": {
"navamsa": true,
"navamsa_number": 9,
"bhaga": false,
"bhaga_degree": 21,
"bhaga_by_element": false,
"bhaga_degree_by_element": 21,
"sources_agree": true,
"orb_degrees": 1
}
}
],
"planetary_war": []
}Add baby names by numerology
The Numerology API can also suggest the names. POST /v1/baby-names returns names from its own list whose number suits the baby's date of birth. It reads each name in Chaldean, the letter values Indian numerology uses. Send the surname, and each name is counted with it, the way the child will carry it.
To join the two traditions, get the syllable from POST /v1/reading/section/birth-details with lang=hi. Send it in syllables, and only names that start with that sound come back. Names come grouped by number, A to Z, and are never ranked. The same key works for both APIs.
- 01
Find names whose number suits the baby
POST /v1/baby-namesSend the birth date, and the surname if you have it. Narrow the list by gender, by birth-star syllables in Hindi letters, or by English starting letters such as J. Each name comes with its Hindi spelling and its meaning, when the meaning is known.
- 02
Check the name the parents choose
POST /v1/nameSend the full name and the baby's birth date, with up to 10 other spellings. Each spelling gets its Chaldean number and its fit with the baby's numbers, in the order sent.
Tips for going live
- The Moon moves through one pada in about six hours, so ask for the exact birth time from the birth record. A guessed time can give the wrong syllable.
- Always send the birth place's time zone. The birth star depends on the moment of birth, and 11:30 PM in Los Angeles is a different moment from 11:30 PM in New York.
- The Astrology API gives one syllable for each pada, not a list of names. Tag the names in your own list by their opening sound, or let the Numerology API's POST /v1/baby-names filter its names by the syllable.
- A syllable can be spelled more than one way in English, such as Va or Wa. Match names by sound as well as by spelling.
- Some families follow the syllable closely and others loosely. Present it as a tradition the parents can choose, not a rule.

What it costs
A baby name app with 1,000 new babies a month uses 1,000 calls for the birth stars and 1,000 reading credits for the name syllables. Starter.
Every plan can call every endpoint: calls for calculations, reading credits for written readings. Test keys are free on every plan, with 1,000 calls a month. Paid plans start at $29 a month, and failed requests are free.
See pricingTry it free
See an answer first
Nakshatra finder
Your birth star: the Moon's nakshatra, its quarter (pada), its ruler and your Moon sign.
Find my nakshatra
Features used here
Read next
From the blog
Common questions
All questionsWhich field holds the name syllable?
naamakshar, in the birth_details object of POST /v1/reading/section/birth-details. The same object has the nakshatra, its pada, the Moon sign and the rest of the avakhada chakra. POST /v1/planets gives the Moon's nakshatra and pada, but not the syllable.
What the avakhada chakra isDoes the API suggest baby names?
The Astrology API gives the syllable, not names. Your app can match it to names from its own list. Or the Numerology API, on the same key, can suggest names whose number suits the child, starting with that syllable.
What a nakshatra isHow is the syllable chosen?
Each of the 27 nakshatras has four quarters (padas), and tradition gives each quarter its own syllable, 108 in all. The API reads the quarter the Moon was in at birth. For example, Rohini pada 2 gives Va, and Mrigashira pada 1 gives Ve.
Read the ruleCan we show the syllable in Hindi?
Yes. Send lang=hi and the syllable comes back in Devanagari, such as वा for Va, along with the Hindi names of the nakshatra and the Moon sign.
Read the conventionsWhat if the parents are not sure of the birth time?
Use the time on the birth record. The Moon changes pada about every six hours, so a time that is off can give a different syllable. If the time is uncertain, check a few hours either side, and when the syllable changes, show both to the parents.
Try the nakshatra finderIs the birth star the same as the baby's zodiac sign?
No. The birth star is the Moon's nakshatra in the Vedic (sidereal) zodiac. It has nothing to do with the Western Sun sign many parents know. The Vedic Moon sign is broader too: each sign holds parts of three nakshatras.
Vedic and Western comparedAstrology API
Start with a free test key
Create an account and a test key, then try each step above. Need more than the largest plan? Write to us.
Your first answer
John Doe, New York
- RisingVirgoHast
- SunCancerAshlesha
- MoonTaurusMrigashira
- MarsAriesKrittika
Real API output. A free test key gets the same answer.
01
Test key: 1,000 test calls a month to build with
02
Free plan: 2,000 live calls a month, no card needed
03
Open rules: every rule is published, so you can check any answer
