Two people

Numerology Compatibility API for Two Birth Dates

The numerology compatibility API from API for Astrology (apiforastrology.com) compares two people's numbers from their birth dates. Each person's mulank (birth day number) and bhagyank (destiny number) are read both ways, as four links. You get one plain outcome (good, neutral, mixed or difficult) and a short reading, with no score. One call costs 1 reading credit.

Get a free API key Try it in the API reference

Updated Nov 7, 2026

How the numerology compatibility API works

1Send two birth dates, such as John Doe's, August 15, 1990, and Jane Doe's, March 22, 1992.
2The API finds each mulank and bhagyank: 6 and 6 for John, and 4 and 1 for Jane.
3It reads four one-way links between them and returns one outcome, which is mixed for this pair.

POST /v1/compatibility200 OK

{
  "a": {
    "mulank": 6,
    "bhagyank": 6
  },
  "b": {
    "mulank": 4,
    "bhagyank": 1
  },
  "outcome": "mixed",
  "reading": "Your numbers pull both ways. Some things come easily between you and some need patience."
}

John Doe and Jane Doe: each one's mulank and bhagyank, and the outcome read both ways. Real output for John Doe, born Aug 15, 1990, and Jane Doe, born Mar 22, 1992.

The four links for John Doe and Jane Doe

This is the real answer for John Doe, born August 15, 1990, and Jane Doe, born March 22, 1992. John's mulank and bhagyank are 6 and 6. Jane's are 4 and 1.

The four links for John Doe and Jane Doe
Link	Numbers	Relation
John's mulank to Jane's	6 (Venus) to 4 (Rahu, read as Saturn)	Friend
Jane's mulank to John's	4 (Rahu, read as Saturn) to 6 (Venus)	Friend
John's bhagyank to Jane's	6 (Venus) to 1 (Sun)	Enemy
Jane's bhagyank to John's	1 (Sun) to 6 (Venus)	Enemy
Outcome	Two friends and two enemies	Mixed

Every answer ends with the same caution in its not_claimed field: “Numbers describe tendencies, not fixed events. Use them as a guide, not a rule.”

See which numbers are friends

Call the numerology compatibility API from your code

Send the details as JSON with your API key in the Authorization header. Copy the code, set ASTROLOGY_API_KEY to your key, and run it. The same key works for the Astrology API.

POST /v1/compatibility

# John Doe, born Aug 15, 1990, and Jane Doe, born Mar 22, 1992
curl -X POST "https://apiforastrology.com/api/numerology/v1/compatibility" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"a":{"birth_date":"1990-08-15"},"b":{"birth_date":"1992-03-22"}}'

Response (lists shortened)200 OK

{
  "a": {
    "birth_date": "1990-08-15",
    "mulank": 6,
    "bhagyank": 6,
    "mulank_planet": "Venus"
  },
  "b": {
    "birth_date": "1992-03-22",
    "mulank": 4,
    "bhagyank": 1,
    "mulank_planet": "Rahu"
  },
  "links": [
    {
      "from": "mulank",
      "from_number": 6,
      "to_number": 4,
      "relation": "friend",
      "via": [
        "Rahu"
      ],
      "who": "a_to_b",
      "from_name": "mulank",
      "relation_name": "friendly"
    },
    {
      "from": "mulank",
      "from_number": 4,
      "to_number": 6,
      "relation": "friend",
      "via": [
        "Rahu"
      ],
      "who": "b_to_a",
      "from_name": "mulank",
      "relation_name": "friendly"
    }
  ],
  "outcome": "mixed",
  "outcome_name": "Mixed",
  "reading": "Your numbers pull both ways. Some things come easily between you and some need patience.",
  "not_claimed": "Numbers describe tendencies, not fixed events. Use them as a guide, not a rule.",
  "localization": {
    "lang": "en",
    "detail": "standard",
    "fell_back_to_en": [],
    "fell_back_to_standard": []
  }
}

What the numerology compatibility API returns

Each person's birth date, mulank and bhagyank, and the planet of the mulank.
Four links: how each person's mulank counts the other's, and the same for the two bhagyanks.
Each link's relation: same, friend, neutral or enemy. via shows when Rahu or Ketu was read as Saturn or Mars.
One outcome over all four links: good, neutral, mixed or difficult.
A short reading of that outcome, in English or Hindi, at standard or expanded length.

Nothing is scored, so there is no percent and no points total. The outcome comes from one stated rule over the four links. Your app can show those links as the reason.

Numerology compatibility API endpoints

POST /v1/compatibilityTwo people

What it uses from your plan

Every numerology answer is a written reading, so it uses reading credits and no calls. The price is the same in every language and at either length. Failed requests are free.

Two people1 credit

Numerology API pricing

The rules behind the numerology compatibility API

Two numbers get along when their planets are friends in the classical table. That friendship can be one-sided, so every link is read in both directions. Rahu and Ketu are read as Saturn and Mars, and the answer says so. The outcome uses the name checker's rule: a friend and no enemy is good, one of each is mixed.

The mulank (birth day number) is the day of birth, added down to one digit. The 1st, 10th, 19th and 28th all give 1, as in Cheiro's Book of Numbers (1926). Numerology turns a person's name and date of birth into numbers, as described by Encyclopaedia Britannica.

Read the conventions

Terms used here

Who uses it

Related features

From the blog

Numerology compatibility API questions

All questions

Does the numerology compatibility check need names or birth times?

No. It needs only two birth dates, one for each person, in YYYY-MM-DD form. Names, birth times and places are not used.

Why are there four links and not one?

The friendship of numbers can be one-sided. For example, 9 (Mars) counts 2 (the Moon) as a friend, while 2 counts 9 as neutral. So each person's mulank is read against the other's both ways, and the same is done for the bhagyanks.

What friendly numbers are

Is there a compatibility score?

No. Nothing is scored or added up. The outcome comes from one rule over the four links. A friend and no enemy is good, and an enemy and no friend is difficult. One of each is mixed, and neither is neutral.

What do John Doe and Jane Doe get?

John Doe, born August 15, 1990, has mulank 6 and bhagyank 6. Jane Doe, born March 22, 1992, has mulank 4 and bhagyank 1. Their mulanks count each other as friends, and their bhagyanks count each other as enemies. So the outcome is mixed.

Can I use numerology compatibility for a marriage match?

It reads numbers only. For a Vedic marriage match from two birth charts, with the 36 points, use the Astrology API's kundli matching. The same key works for both, and kundli matching works from birth dates, times and places.

See kundli matching

What does a numerology compatibility call cost?

1 reading credit per live call, in every language and at either length. Test keys answer for John Doe and Jane Doe, the sample pair in the docs.

See numerology credits

Numerology API

Call it with a free test key

Create an account and a test key, then call any endpoint on this page with the sample people. Or try a request in the API reference first.

Get a free API key Open the API reference

Your first answer

John Doe, born Aug 15, 1990

POST /v1/profile200 OK

Mulank6Venus
Bhagyank6Destiny number
Name number7Ketu

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
One key: the same key, plan and reading credits as the Astrology API