Sign In Get API Key

Numerology API — Mulank to life path. Lucky numbers to baby names.

The numerology features people actually search for, ready to ship. Is my mobile number lucky. What should we name the baby. Will this brand name work. Are we compatible. Four traditions sit behind the answers - Indian, Western, Chaldean and Chinese - and every number comes back dressed for the page, with its archetype, its lucky colours and gemstone, its ruling planet and mantra, and the full working so your users can follow the arithmetic themselves. All it needs from them is a date of birth and a name.

Get API Key → Read the docs
42+
Endpoints
4 systems
Traditions covered
<50ms
Median latency
JSON
Documented fields
Mental 4 Rahu 9 Mars 2 Moon Emotional 3 Jupiter 5 Mercury 7 Ketu Practical 8 Saturn 1 Sun 6 Venus Every row, column and diagonal sums to 15

Lo Shu · Mulank · Bhagyank · Kua · Chaldean · Pythagorean

  • Four traditions Indian, Western, Chaldean and Chinese - each true to its own sources.
  • Lucky number checks Mobile, vehicle, house, flat, bank account, email and signature.
  • Real baby names A curated collection across Indian, universal, Muslim and Sikh traditions.
  • Scores with verdicts Out of a hundred, with a sentence anyone can act on.
  • The working shown Every reduction step and every letter value returned.
  • No birth time needed A date and a name. No city, no coordinates, no time zones.
What you can launch this week

The features people
actually pay for.

Lucky mobile numbers. Baby names. Business names. Match scores. These are the things your users search for, share with friends, and come back to check again — and every one of them is a single call away.

Lucky number checkers

  • Mobile numbers, vehicle numbers, house and flat numbers
  • Bank accounts, email addresses, even signatures
  • Works on its own, or matched against the user's own date of birth
  • The most shared feature in any numerology app

Baby name finder

  • Real names from a curated collection, not generated syllables
  • Indian, universal, Muslim and Sikh naming traditions
  • Hundreds of candidates scored against the child's own numbers
  • Each suggestion comes with its meaning and why it fits

Business and brand naming

  • Score any name out of a hundred before it goes on a signboard
  • A clear verdict, not a number the founder has to interpret
  • Letter-by-letter breakdown that shows the working
  • Name suggestions when the score comes back weak

Indian numerology sections

  • Mulank, Bhagyank and Naamank — the names readers already know
  • Driver and conductor number with their relationship
  • The Lo Shu grid, ready to render as a three-by-three
  • Kua number with lucky and unlucky directions

Match and compatibility

  • A score out of a hundred with a plain-language verdict
  • Broken down by day-to-day nature and life direction
  • Strengths, friction points and what to watch for
  • Couples, and business partners too

Personal year and forecasts

  • Personal year, month and day cycles
  • Pinnacles and challenges across a lifetime
  • Favourable dates for anything that needs timing
  • A yearly overview page for every number

Full personality profiles

  • Life path, expression, soul urge, personality and more
  • An archetype and a headline for the top of the card
  • Strengths and shadows stated honestly, not flattered
  • Career fits, relationship patterns, health tendencies

Name correction services

  • Show where a spelling sits and what it could become
  • Alternative spellings scored against the birth numbers
  • The consultation that numerologists charge the most for
  • Now a form on your site instead of an appointment

Remedy and lucky sections

  • Lucky days, dates, colours, gemstone, metal and direction
  • Colours arrive as usable values, ready to theme the page
  • A mantra and a ruling planet for every number
  • Friendly and unfriendly numbers at a glance

A date of birth and a name. That is everything the API needs from your user.

Four traditions, one key

Most numerology APIs
know one system.

A reader in Jaipur wants their mulank. A reader in Chicago wants their life path. A founder naming a company wants the Chaldean verdict. A family choosing a front door wants their Kua direction. All four live here, and they agree with their own classical sources rather than being rebranded versions of each other.

Indian

  • Mulank, Bhagyank, Naamank
  • Driver and conductor, and how they get along
  • The Lo Shu grid with its three planes
  • Ruling planet, in Sanskrit as well as English

Western

  • Life path, expression, soul urge, personality
  • Birthday, attitude and maturity numbers
  • Master numbers and karmic debt detected properly
  • An archetype, not just a digit

Chaldean

  • The older mapping, letter by letter
  • Compound number meanings alongside the reduced one
  • A suitability score for any name you test
  • The system serious name consultants actually use

Chinese

  • Kua number, with the lunar new year handled correctly
  • East and West group placement
  • Four favourable and four unfavourable directions
  • Each one named, translated and explained
Every number, fully dressed

You get a page,
not a digit.

Anyone can reduce a birth date to a single number in three lines of code. What takes years to build is everything that has to sit around that number before it is worth publishing.

The character

  • An archetype name and a headline that lands
  • Keywords and core traits
  • Shadow traits, stated plainly
  • The gift, the challenge, the lesson

The life areas

  • Careers the number suits
  • How they behave in relationships
  • Health tendencies worth knowing
  • Which numbers they get on with

The lucky set

  • Lucky days and dates
  • Colours that arrive ready to use on screen
  • Gemstone, metal and direction
  • A mantra and the ruling planet

The design

  • A headline written for the top of a card
  • An accent colour chosen for the number
  • Grids and breakdowns shaped for the screen
  • Your designer will thank you

The working

  • Every reduction step shown, not hidden
  • Letter-by-letter values for any name
  • Users can follow the maths themselves
  • Trust that a bare number never earns

The verdict

  • Scores out of a hundred where a score makes sense
  • A label and a tone, so your UI knows how to feel
  • A sentence a normal person can act on
  • No interpretation left to your front end

Forty-two endpoints. Indian, Western, Chaldean and Chinese. One key, one JSON shape, one bill.

The questions people actually type

Is my mobile number lucky. What should we name the baby. Will this business name work. Are we compatible. These are the searches that bring people to a numerology page, and each one is a single call away rather than something you have to assemble from raw numbers yourself.

Indian numerology, not a translation of the Western kind

Mulank, Bhagyank and Naamank by their own names, the driver and conductor pair with the relationship between them, the Lo Shu grid across its three planes, and the Kua number with its favourable directions. Readers in India recognise these instantly, and they are what they are searching for.

Every number arrives dressed for the page

An archetype and a headline, honest strengths and shadows, career fits, relationship patterns, health tendencies, lucky days, dates, colours, gemstone, metal and direction, a ruling planet with its Sanskrit name, and a mantra. Reducing a birth date takes three lines of code. Everything around it is the product.

Shows its working, so readers trust it

Each reduction step is returned rather than hidden, and every name comes back letter by letter with its values. A user who can follow the arithmetic believes the result. A bare number always looks like it was guessed.

03 / Numerology · Indian · Western · Chaldean · Chinese

All Numerology endpoints

Every endpoint returns structured JSON with documented fields, validated coordinates, and IANA timezone IDs.

42+
Endpoints

Indian Numerology

7 EP

Mulank, Bhagyank and Naamank, the driver and conductor pair, the Lo Shu grid across its three planes, and the Kua number with its lucky and unlucky directions.

  • POST /api/v3/numerology/indian/complete
  • POST /api/v3/numerology/indian/mulank
  • POST /api/v3/numerology/indian/bhagyank
  • POST /api/v3/numerology/indian/lo-shu-grid
  • POST /api/v3/numerology/indian/kua-number
+2 more in the docs →

Lucky Number Checks

8 EP

The most shared feature in any numerology app. Any number or string read on its own, or matched against the person's own date of birth.

  • POST /api/v3/numerology/analyze/mobile
  • POST /api/v3/numerology/analyze/vehicle
  • POST /api/v3/numerology/analyze/house
  • POST /api/v3/numerology/analyze/bank-account
  • POST /api/v3/numerology/analyze/signature
+3 more in the docs →

Western Numerology

8 EP

Life path, expression, soul urge, personality, birthday, attitude and maturity - each on its own, or all of them together in a single call.

  • POST /api/v3/numerology/western/complete
  • POST /api/v3/numerology/western/life-path
  • POST /api/v3/numerology/western/expression
  • POST /api/v3/numerology/western/soul-urge
  • POST /api/v3/numerology/western/personality
+3 more in the docs →

Cycles & Forecasts

8 EP

Personal year, month and day, pinnacles and challenges across a lifetime, favourable dates for anything that needs timing, and a full year overview.

  • POST /api/v3/numerology/forecast/personal-year
  • POST /api/v3/numerology/forecast/personal-month
  • POST /api/v3/numerology/forecast/personal-day
  • POST /api/v3/numerology/forecast/pinnacles
  • POST /api/v3/numerology/forecast/favorable-dates
+3 more in the docs →

Chaldean Names

4 EP

The older letter mapping, with compound meanings alongside the reduced number and a suitability score for any name you put through it.

  • POST /api/v3/numerology/chaldean/complete
  • POST /api/v3/numerology/chaldean/name
  • POST /api/v3/numerology/chaldean/compound-meaning
  • POST /api/v3/numerology/chaldean/single-digit-meaning

Name Suggestions

4 EP

Real names scored and ranked against a person's own numbers - for babies, for businesses, and for anyone considering a change of spelling.

  • POST /api/v3/numerology/suggest/baby-name
  • POST /api/v3/numerology/suggest/business-name
  • POST /api/v3/numerology/suggest/name
  • POST /api/v3/numerology/astro/name-correction

Compatibility

3 EP

A score out of a hundred with a plain verdict, broken into axes that show exactly where two people fit and where they will rub.

  • POST /api/v3/numerology/compatibility/dob-dob
  • POST /api/v3/numerology/compatibility/full-profile
  • POST /api/v3/numerology/compatibility/business-partner
One call

A date in. A profile out.

Real response, trimmed. Every number arrives with its archetype, its lucky set and the working behind it.

Request 
curl -X POST https://starsapi.com/api/v3/numerology/indian/complete \
  -H "X-Api-Key: $KEY" -H "Content-Type: application/json" \
  -d '{"year":1990,"month":1,"day":12,"name":"Aarav Sharma"}'
Response 11 ms 
{
  "mulank": {
    "mulank": 3,
    "reduction_steps": [ 12, 3 ],
    "meaning": {
      "name": "The Communicator",
      "planet": "Jupiter",
      "planet_sanskrit": "Brihaspati / Guru",
      "element": "Ether",
      "keywords": [ "expression", "wisdom", "optimism", "expansion" ],
      "strengths": "Wise, optimistic, expressive, scholarly, generous.",
      "weaknesses": "Overconfident, preachy, scattered, financially careless.",
      "career": "Teaching, law, judiciary, banking, publishing, writing.",
      "health": "Liver, weight gain, diabetes, sciatica.",
      "lucky_days": [ "Thursday", "Sunday" ],
      "lucky_dates": [ 3, 12, 21, 30 ],
      "lucky_colors": [ { "name": "Guru Gold", "hex": "#f39c12" } ],
      "lucky_gem": "Yellow Sapphire",
      "lucky_metal": "Gold",
      "lucky_direction": "North-East",
      "mantra": "Om Gram Greem Graum Sah Gurave Namah",
      "friendly_numbers": [ 1, 3, 9 ]
    }
  }
}
Frequently asked

Numerology API — questions before you build.

Is there a free numerology API I can test without a credit card?
Yes. StarsAPI's free tier lets you evaluate any endpoint without entering a card, so you can run a full numerology profile and see the actual response before committing to anything. Paid plans start at $29 a month and include every endpoint on the platform, numerology among them — there is no separate numerology bill.
Is my mobile number lucky? Can I check it through an API?
Yes, and it is the single most popular thing anyone builds with this. Send a mobile number and get back its compound and reduced values, the ruling planet, and what that number brings and costs its owner. Add the person's date of birth and the reading becomes specific to them rather than general. Vehicle numbers, house and flat numbers, bank accounts, email addresses and signatures each have their own endpoint too.
Is there an Indian numerology API with mulank and bhagyank?
Yes, by those names and calculated their own way rather than relabelled from the Western system. Mulank, bhagyank and naamank, the driver and conductor pair with the relationship between them, the Lo Shu grid across its three planes, and the Kua number with its favourable directions. This is the half of numerology that Indian readers actually search for, and most numerology APIs skip it entirely.
Can I build a baby name suggestion feature with numerology?
Yes. Send the child's date of birth and hundreds of real names are scored against that child's own numbers and ranked — real names from a curated collection, not syllables generated on the fly. Indian, universal, Muslim and Sikh traditions are covered and you can narrow to whichever you want. Each suggestion arrives with its number, its classical meaning and how closely it matches.
How do I check whether a business name is numerologically good?
Any name comes back with a score out of a hundred and a plain verdict, plus the letter-by-letter breakdown behind it and the meaning of both the compound and reduced numbers. If a name scores badly the suggestion endpoint offers alternatives that score better. It is the check founders want before a name goes on a signboard, and it takes one request.
What is the difference between Pythagorean and Chaldean numerology?
Pythagorean assigns numbers to letters in alphabetical order and is the system most Western numerology uses. Chaldean is older, maps letters by sound rather than sequence, and treats the compound number as carrying meaning of its own alongside the reduced one. Serious name consultants generally work in Chaldean. Both are here, along with the Indian and Chinese systems, and each follows its own sources rather than one system wearing four labels.
Which numbers does the numerology API calculate?
On the Western side: life path, expression, soul urge, personality, birthday, attitude and maturity, with master numbers and karmic debt detected properly rather than flattened. On the Indian side: mulank, bhagyank, naamank, driver and conductor, Lo Shu grid and Kua. Chaldean covers name analysis with compound meanings. Cycles cover personal year, month and day, pinnacles, challenges and favourable dates.
Does the API return interpretations or just the numbers?
A full page worth. Every number arrives with an archetype and a headline, keywords, honest strengths and shadow traits, careers it suits, relationship patterns, health tendencies, lucky days, dates, colours, gemstone, metal and direction, the ruling planet with its Sanskrit name, and a mantra. Colours come as values you can use directly, and each number has an accent colour picked for it so a card can be themed without a designer choosing one.
Is there a numerology compatibility API for couples?
Yes. Two dates of birth come back as a score out of a hundred with a label and a verdict written in ordinary language, broken into axes that show how the day-to-day natures sit together and how the life directions align, each with its own score and weighting. Business partner compatibility is scored separately, on the axes that matter for a partnership rather than a marriage.
What is a Lo Shu grid and can I display one?
It is the classical three-by-three arrangement in which every row, column and diagonal sums to fifteen. The API returns it already shaped as a grid, showing which numbers appear in a person's birth date and how often across the mental, emotional and practical planes. It drops straight into a three-by-three layout with no rearranging on your side.
Do I need a birth time or birth place for numerology?
No. A date of birth is enough for most of it and a name for the rest. Nothing needs a birth time, a city or coordinates, which means a numerology feature can go live without a location lookup or a single time-zone problem anywhere in your product — a much lower barrier than astrology, and a good first paid feature for that reason.
Can I offer name correction as a paid service?
Yes, and it is what numerologists charge the most for. Send an existing name and get back where it currently sits along with alternative spellings scored against the person's birth numbers. What used to require an appointment becomes a form on your site that runs day and night.
Continue exploring

Related astrology APIs.

AI Reports

AI Reports

Sell astrology reports with your name on the cover.

Explore AI Reports Vedic Astrology

Vedic Astrology API

Calculations, predictions and remedies — in one response.

Explore Vedic Astrology API AI Chat Astrologer

AI Chat Astrologer

Plug-and-play AI astrologers for your app or website.

Explore AI Chat Astrologer
Ready when you are

Every domain.
One subscription.

Plans from $29/mo. Vedic, Western, Numerology, Transits, Horoscopes, AI Astrologers and Reports, with the Location API included.

View pricing → Browse all products