Numerology

Chaldean numerology: core numbers, name, mobile number, Lo Shu grid, compatibility.

Life path, destiny, soul urge, personality (Chaldean)

POST/v1/numerology/core

1 credit · Secret key (test or live) · getNumerologyCore · Page for this operation

Request body

name string
at least 1 characters · at most 120 characters
date_of_birth string (date) required
e.g. "1990-08-13"

No other fields are accepted.

Response

JSON { data, meta, warnings }, where data is:

life_path integer required
destiny integer or null required
One of:
1. integer
2. null
soul_urge integer or null required
One of:
1. integer
2. null
personality integer or null required
One of:
1. integer
2. null
birth_number integer required
ruling_planet string required
lucky_numbers array of integer required
hidden_passion integer or null required
One of:
1. integer
2. null
maturity integer or null required
One of:
1. integer
2. null
personal_year integer required
personal_month integer required
personal_day integer required
life_path_meaning object required
- name string required
- keyword string required
- traits string required
soul_urge_meaning string or null required
One of:
1. string
2. null
personality_meaning string or null required
One of:
1. string
2. null
lucky_colors array of string required
lucky_days array of string required
lucky_gem string required
name_breakdown array of LetterValue or null required
One of:
1. array of LetterValue
  Fields
  - letter string required
  - value integer required
    ≥ 0 · ≤ 8
  - type string required
    one of vowel, consonant
2. null

Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.

Example request

curl -X POST 'https://api.astrologics.in/v1/numerology/core' \
  -H 'Authorization: Bearer al_test_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Asha Verma","date_of_birth":"1990-08-13"}'

Node.js

const res = await fetch("https://api.astrologics.in/v1/numerology/core", {
  method: "POST",
  headers: { Authorization: "Bearer al_test_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    "name": "Asha Verma",
    "date_of_birth": "1990-08-13"
  }),
});
console.log(JSON.stringify(await res.json(), null, 2));

Python

import json
import urllib.error
import urllib.request

body = {
    "name": "Asha Verma",
    "date_of_birth": "1990-08-13",
}

req = urllib.request.Request(
    "https://api.astrologics.in/v1/numerology/core",
    method="POST",
    headers={"Authorization": "Bearer al_test_YOUR_KEY", "Content-Type": "application/json"},
    data=json.dumps(body).encode(),
)
try:
    with urllib.request.urlopen(req) as res:
        print(json.dumps(json.load(res), indent=2, ensure_ascii=False))
except urllib.error.HTTPError as err:
    print(err.code, err.read().decode())

PHP

<?php
$ch = curl_init('https://api.astrologics.in/v1/numerology/core');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"name":"Asha Verma","date_of_birth":"1990-08-13"}',
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 1,891 characters

{
  "data": {
    "life_path": 4,
    "destiny": 1,
    "soul_urge": 8,
    "personality": 2,
    "birth_number": 4,
    "ruling_planet": "rahu",
    "lucky_numbers": [
      4,
      13,
      22,
      31
    ],
    "hidden_passion": 1,
    "maturity": 5,
    "personal_year": 4,
    "personal_month": 6,
    "personal_day": 9,
    "life_path_meaning": {
      "name": "The Builder",
      "keyword": "Stability & discipline",
      "traits": "Practical, disciplined, loyal and hardworking. Builds lasting foundations through patience."
    },
    "soul_urge_meaning": "Inside you desire success, recognition, influence and material mastery.",
    "personality_meaning": "Others see you as gentle, warm, tactful and easy to approach.",
    "lucky_colors": [
      "Blue",
      "Grey",
      "Khaki"
    ],
    "lucky_days": [
      "Saturday",
      "Sunday"
    ],
    "lucky_gem": "Hessonite (Gomed)",
    "name_breakdown": [
      {
        "letter": "A",
        "value": 1,
        "type": "vowel"
      },
      {
        "letter": "S",
        "value": 3,
        "type": "consonant"
      },
      {
        "letter": "H",
        "value": 5,
        "type": "consonant"
      },
      {
        "letter": "A",
        "value": 1,
        "type": "vowel"
      },
      {
        "letter": "V",
        "value": 6,
        "type": "consonant"
      },
      {
        "letter": "E",
        "value": 5,
        "type": "vowel"
      },
      {
        "letter": "R",
        "value": 2,
        "type": "consonant"
      },
      {
        "letter": "M",
        "value": 4,
        "type": "consonant"
      },
      {
        "letter": "A",
        "value": 1,
        "type": "vowel"
      }
    ]
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.10.10",
    "mode": "live",
    "credits_charged": 1
  },
  "warnings": []
}

Try it

Test key (optional)

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one

Body (JSON)

{
  "name": "Asha Verma",
  "date_of_birth": "1990-08-13"
}

Pythagorean numbers: core, karmic debts and lessons, pinnacles, challenges and personal year

POST/v1/numerology/pythagorean

1 credit · Secret key (test or live) · getPythagorean · Page for this operation

The Western letter table (A=1 to I=9, then round again), reducing month, day and year separately. The name is optional: without it, name numbers are null.

Request body

date_of_birth string (date) required
e.g. "1990-08-13"
name string
The full name at birth, in Latin letters, without titles or suffixes.
at least 1 characters · at most 120 characters
as_of string (date)
The date for the personal year and month. Default: today in IST.
e.g. "1990-08-13"

No other fields are accepted.

Response

JSON { data, meta, warnings }, where data is:

life_path PythagoreanReading required
- value integer required
- total integer required
  The sum before the last reduction.
- is_master boolean required
- karmic_debt integer or null required
  One of:
  1. integer
  2. null
birthday object required
- value integer required
- day integer required
- is_master boolean required
period_cycles object required
- month integer required
- day integer required
- year integer required
expression PythagoreanReading or null required
One of:
1. PythagoreanReading
  Fields
  - value integer required
  - total integer required
    The sum before the last reduction.
  - is_master boolean required
  - karmic_debt integer or null required
    One of:
    1. integer
    2. null
2. null
soul_urge PythagoreanReading or null required
One of:
1. PythagoreanReading
  Fields
  - value integer required
  - total integer required
    The sum before the last reduction.
  - is_master boolean required
  - karmic_debt integer or null required
    One of:
    1. integer
    2. null
2. null
personality PythagoreanReading or null required
One of:
1. PythagoreanReading
  Fields
  - value integer required
  - total integer required
    The sum before the last reduction.
  - is_master boolean required
  - karmic_debt integer or null required
    One of:
    1. integer
    2. null
2. null
balance PythagoreanReading or null required
One of:
1. PythagoreanReading
  Fields
  - value integer required
  - total integer required
    The sum before the last reduction.
  - is_master boolean required
  - karmic_debt integer or null required
    One of:
    1. integer
    2. null
2. null
maturity PythagoreanReading or null required
One of:
1. PythagoreanReading
  Fields
  - value integer required
  - total integer required
    The sum before the last reduction.
  - is_master boolean required
  - karmic_debt integer or null required
    One of:
    1. integer
    2. null
2. null
cornerstone integer or null required
One of:
1. integer
2. null
capstone integer or null required
One of:
1. integer
2. null
karmic_lessons array of integer or null required
One of:
1. array of integer
2. null
hidden_passion array of integer or null required
One of:
1. array of integer
2. null
subconscious_self integer or null required
One of:
1. integer
2. null
letters array of object or null required
One of:
1. array of object
  Fields
  - name string required
  - letters array of object required
    Fields
    letter string required
    value integer required
    type string required
    one of vowel, consonant
2. null
karmic_debts array of object required
- number integer required
- in string required
  one of life_path, expression, soul_urge, personality, birthday, birth_year
pinnacles array of object required
- number integer required
- from_age integer required
- to_age integer or null required
  One of:
  1. integer
  2. null
challenges object required
- first integer required
- second integer required
- main integer required
- fourth integer required
personal object required
- as_of string (date) required
  e.g. "1990-08-13"
- year integer required
- month integer required
meanings object required
- life_path PythagoreanMeaning or null required
  One of:
  1. PythagoreanMeaning
    Fields
    - name string required
    - keyword string required
    - traits string required
  2. null
- expression PythagoreanMeaning or null required
  One of:
  1. PythagoreanMeaning
    Fields
    - name string required
    - keyword string required
    - traits string required
  2. null
- soul_urge PythagoreanMeaning or null required
  One of:
  1. PythagoreanMeaning
    Fields
    - name string required
    - keyword string required
    - traits string required
  2. null
- personality PythagoreanMeaning or null required
  One of:
  1. PythagoreanMeaning
    Fields
    - name string required
    - keyword string required
    - traits string required
  2. null
source object required
- system string required
- text string required
- meanings string required

Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.

Example request

curl -X POST 'https://api.astrologics.in/v1/numerology/pythagorean' \
  -H 'Authorization: Bearer al_test_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"date_of_birth":"1990-08-12","name":"Asha Rao","as_of":"2026-01-01"}'

Node.js

const res = await fetch("https://api.astrologics.in/v1/numerology/pythagorean", {
  method: "POST",
  headers: { Authorization: "Bearer al_test_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    "date_of_birth": "1990-08-12",
    "name": "Asha Rao",
    "as_of": "2026-01-01"
  }),
});
console.log(JSON.stringify(await res.json(), null, 2));

Python

import json
import urllib.error
import urllib.request

body = {
    "date_of_birth": "1990-08-12",
    "name": "Asha Rao",
    "as_of": "2026-01-01",
}

req = urllib.request.Request(
    "https://api.astrologics.in/v1/numerology/pythagorean",
    method="POST",
    headers={"Authorization": "Bearer al_test_YOUR_KEY", "Content-Type": "application/json"},
    data=json.dumps(body).encode(),
)
try:
    with urllib.request.urlopen(req) as res:
        print(json.dumps(json.load(res), indent=2, ensure_ascii=False))
except urllib.error.HTTPError as err:
    print(err.code, err.read().decode())

PHP

<?php
$ch = curl_init('https://api.astrologics.in/v1/numerology/pythagorean');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"date_of_birth":"1990-08-12","name":"Asha Rao","as_of":"2026-01-01"}',
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 3,923 characters

{
  "data": {
    "life_path": {
      "value": 3,
      "total": 12,
      "is_master": false,
      "karmic_debt": null
    },
    "birthday": {
      "value": 3,
      "day": 12,
      "is_master": false
    },
    "period_cycles": {
      "month": 8,
      "day": 3,
      "year": 1
    },
    "expression": {
      "value": 9,
      "total": 18,
      "is_master": false,
      "karmic_debt": null
    },
    "soul_urge": {
      "value": 9,
      "total": 9,
      "is_master": false,
      "karmic_debt": null
    },
    "personality": {
      "value": 9,
      "total": 18,
      "is_master": false,
      "karmic_debt": null
    },
    "balance": {
      "value": 1,
      "total": 10,
      "is_master": false,
      "karmic_debt": null
    },
    "cornerstone": 1,
    "capstone": 1,
    "karmic_lessons": [
      2,
      3,
      4,
      5,
      7
    ],
    "hidden_passion": [
      1
    ],
    "subconscious_self": 4,
    "letters": [
      {
        "name": "asha",
        "letters": [
          {
            "letter": "A",
            "value": 1,
            "type": "vowel"
          },
          {
            "letter": "S",
            "value": 1,
            "type": "consonant"
          },
          {
            "letter": "H",
            "value": 8,
            "type": "consonant"
          },
          {
            "letter": "A",
            "value": 1,
            "type": "vowel"
          }
        ]
      },
      {
        "name": "rao",
        "letters": [
          {
            "letter": "R",
            "value": 9,
            "type": "consonant"
          },
          {
            "letter": "A",
            "value": 1,
            "type": "vowel"
          },
          {
            "letter": "O",
            "value": 6,
            "type": "vowel"
          }
        ]
      }
    ],
    "maturity": {
      "value": 3,
      "total": 12,
      "is_master": false,
      "karmic_debt": null
    },
    "karmic_debts": [
      {
        "number": 19,
        "in": "birth_year"
      }
    ],
    "pinnacles": [
      {
        "number": 11,
        "from_age": 0,
        "to_age": 33
      },
      {
        "number": 4,
        "from_age": 33,
        "to_age": 42
      },
      {
        "number": 6,
        "from_age": 42,
        "to_age": 51
      },
      {
        "number": 9,
        "from_age": 51,
        "to_age": null
      }
    ],
    "challenges": {
      "first": 5,
      "second": 2,
      "main": 3,
      "fourth": 7
    },
    "personal": {
      "as_of": "2026-01-01",
      "year": 3,
      "month": 4
    },
    "meanings": {
      "life_path": {
        "name": "The Creative",
        "keyword": "Expression & optimism",
        "traits": "Expressive, social, artistic and joyful. A communicator who inspires and uplifts."
      },
      "expression": {
        "name": "The Humanitarian",
        "keyword": "Compassion & completion",
        "traits": "Compassionate, idealistic, courageous and universal. Here to serve a greater cause."
      },
      "soul_urge": {
        "name": "The Humanitarian",
        "keyword": "Compassion & completion",
        "traits": "Compassionate, idealistic, courageous and universal. Here to serve a greater cause."
      },
      "personality": {
        "name": "The Humanitarian",
        "keyword": "Compassion & completion",
        "traits": "Compassionate, idealistic, courageous and universal. Here to serve a greater cause."
      }
    },
    "source": {
      "system": "pythagorean",
      "text": "Modern Western numerology, following the calculation rules Hans Decoz publishes. Not writings of Pythagoras.",
      "meanings": "The AstroLogics number table, shared with the Chaldean operations."
    }
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.10.10",
    "mode": "live",
    "credits_charged": 1
  },
  "warnings": []
}

Try it

Test key (optional)

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one

Body (JSON)

{
  "date_of_birth": "1990-08-12",
  "name": "Asha Rao",
  "as_of": "2026-01-01"
}

Chaldean name number

POST/v1/numerology/name

1 credit · Secret key (test or live) · getNameNumber · Page for this operation

Request body

name string required
at least 1 characters · at most 120 characters

No other fields are accepted.

Response

JSON { data, meta, warnings }, where data is:

number integer required
compound integer required
system "chaldean" required
soul_urge integer required
personality integer required
hidden_passion integer required
letter_breakdown array of LetterValue required
- letter string required
- value integer required
  ≥ 0 · ≤ 8
- type string required
  one of vowel, consonant

Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.

Example request

curl -X POST 'https://api.astrologics.in/v1/numerology/name' \
  -H 'Authorization: Bearer al_test_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Asha Verma"}'

Node.js

const res = await fetch("https://api.astrologics.in/v1/numerology/name", {
  method: "POST",
  headers: { Authorization: "Bearer al_test_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    "name": "Asha Verma"
  }),
});
console.log(JSON.stringify(await res.json(), null, 2));

Python

import json
import urllib.error
import urllib.request

body = {
    "name": "Asha Verma",
}

req = urllib.request.Request(
    "https://api.astrologics.in/v1/numerology/name",
    method="POST",
    headers={"Authorization": "Bearer al_test_YOUR_KEY", "Content-Type": "application/json"},
    data=json.dumps(body).encode(),
)
try:
    with urllib.request.urlopen(req) as res:
        print(json.dumps(json.load(res), indent=2, ensure_ascii=False))
except urllib.error.HTTPError as err:
    print(err.code, err.read().decode())

PHP

<?php
$ch = curl_init('https://api.astrologics.in/v1/numerology/name');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"name":"Asha Verma"}',
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 1,130 characters

{
  "data": {
    "number": 1,
    "compound": 28,
    "system": "chaldean",
    "soul_urge": 8,
    "personality": 2,
    "hidden_passion": 1,
    "letter_breakdown": [
      {
        "letter": "A",
        "value": 1,
        "type": "vowel"
      },
      {
        "letter": "S",
        "value": 3,
        "type": "consonant"
      },
      {
        "letter": "H",
        "value": 5,
        "type": "consonant"
      },
      {
        "letter": "A",
        "value": 1,
        "type": "vowel"
      },
      {
        "letter": "V",
        "value": 6,
        "type": "consonant"
      },
      {
        "letter": "E",
        "value": 5,
        "type": "vowel"
      },
      {
        "letter": "R",
        "value": 2,
        "type": "consonant"
      },
      {
        "letter": "M",
        "value": 4,
        "type": "consonant"
      },
      {
        "letter": "A",
        "value": 1,
        "type": "vowel"
      }
    ]
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.10.10",
    "mode": "live",
    "credits_charged": 1
  },
  "warnings": []
}

Try it

Test key (optional)

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one

Body (JSON)

{
  "name": "Asha Verma"
}

Mobile-number analysis

POST/v1/numerology/mobile

1 credit · Secret key (test or live) · getMobileNumber · Page for this operation

Request body

number string required
pattern ^\+?[0-9 ()-]{4,24}$

No other fields are accepted.

Response

JSON { data, meta, warnings }, where data is:

total integer required
reduced integer required
verdict string required
digits string required
count integer required
planet string required
note string required
favourable boolean required
tip string required

Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.

Example request

curl -X POST 'https://api.astrologics.in/v1/numerology/mobile' \
  -H 'Authorization: Bearer al_test_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"number":"+91 98765 43210"}'

Node.js

const res = await fetch("https://api.astrologics.in/v1/numerology/mobile", {
  method: "POST",
  headers: { Authorization: "Bearer al_test_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    "number": "+91 98765 43210"
  }),
});
console.log(JSON.stringify(await res.json(), null, 2));

Python

import json
import urllib.error
import urllib.request

body = {
    "number": "+91 98765 43210",
}

req = urllib.request.Request(
    "https://api.astrologics.in/v1/numerology/mobile",
    method="POST",
    headers={"Authorization": "Bearer al_test_YOUR_KEY", "Content-Type": "application/json"},
    data=json.dumps(body).encode(),
)
try:
    with urllib.request.urlopen(req) as res:
        print(json.dumps(json.load(res), indent=2, ensure_ascii=False))
except urllib.error.HTTPError as err:
    print(err.code, err.read().decode())

PHP

<?php
$ch = curl_init('https://api.astrologics.in/v1/numerology/mobile');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"number":"+91 98765 43210"}',
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 542 characters

{
  "data": {
    "total": 55,
    "reduced": 1,
    "verdict": "Powerful & lucky",
    "digits": "919876543210",
    "count": 12,
    "planet": "sun",
    "note": "Number 1 (Sun) energises leadership, fame and new starts. Excellent for professionals and founders.",
    "favourable": true,
    "tip": "This number vibration is favourable — a supportive choice."
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.10.10",
    "mode": "live",
    "credits_charged": 1
  },
  "warnings": []
}

Try it

Test key (optional)

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one

Body (JSON)

{
  "number": "+91 98765 43210"
}

Lo Shu grid

POST/v1/numerology/loshu

1 credit · Secret key (test or live) · getLoShu · Page for this operation

Request body

date_of_birth string (date) required
e.g. "1990-08-13"

No other fields are accepted.

Response

JSON { data, meta, warnings }, where data is:

grid array of array of integer required
missing array of integer required
repeated array of integer required
present array of integer required
notes array of string required
arrows object required
- strength array of LoShuArrow required
  Fields
  - line array of integer required
  - meaning string required
- weakness array of LoShuArrow required
  Fields
  - line array of integer required
  - meaning string required
driver object required
- number integer required
- planet string required
conductor object required
- number integer required
- planet string required
summary string required

Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.

Example request

curl -X POST 'https://api.astrologics.in/v1/numerology/loshu' \
  -H 'Authorization: Bearer al_test_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"date_of_birth":"1990-08-13"}'

Node.js

const res = await fetch("https://api.astrologics.in/v1/numerology/loshu", {
  method: "POST",
  headers: { Authorization: "Bearer al_test_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    "date_of_birth": "1990-08-13"
  }),
});
console.log(JSON.stringify(await res.json(), null, 2));

Python

import json
import urllib.error
import urllib.request

body = {
    "date_of_birth": "1990-08-13",
}

req = urllib.request.Request(
    "https://api.astrologics.in/v1/numerology/loshu",
    method="POST",
    headers={"Authorization": "Bearer al_test_YOUR_KEY", "Content-Type": "application/json"},
    data=json.dumps(body).encode(),
)
try:
    with urllib.request.urlopen(req) as res:
        print(json.dumps(json.load(res), indent=2, ensure_ascii=False))
except urllib.error.HTTPError as err:
    print(err.code, err.read().decode())

PHP

<?php
$ch = curl_init('https://api.astrologics.in/v1/numerology/loshu');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"date_of_birth":"1990-08-13"}',
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 1,605 characters

{
  "data": {
    "grid": [
      [
        0,
        2,
        0
      ],
      [
        1,
        0,
        0
      ],
      [
        1,
        2,
        0
      ]
    ],
    "missing": [
      2,
      4,
      5,
      6,
      7
    ],
    "repeated": [
      1,
      9
    ],
    "present": [
      1,
      3,
      8,
      9
    ],
    "notes": [
      "Missing 2: cultivate sensitivity, patience and cooperation.",
      "Missing 4: build discipline, order and practical follow-through.",
      "Missing 5: strengthen emotional balance and adaptability (5 is the centre of feeling & freedom).",
      "Missing 6: develop responsibility toward home and family.",
      "Missing 7: invite growth through learning, sacrifice or spiritual study."
    ],
    "arrows": {
      "strength": [],
      "weakness": [
        {
          "line": [
            2,
            7,
            6
          ],
          "meaning": "Practical plane (action, doing, material) — an area to consciously develop"
        },
        {
          "line": [
            4,
            5,
            6
          ],
          "meaning": "Kindness / prosperity diagonal — an area to consciously develop"
        }
      ]
    },
    "driver": {
      "number": 4,
      "planet": "rahu"
    },
    "conductor": {
      "number": 4,
      "planet": "rahu"
    },
    "summary": "You have 4/9 numbers present. Missing: 2, 4, 5, 6, 7."
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.10.10",
    "mode": "live",
    "credits_charged": 1
  },
  "warnings": []
}

Try it

Test key (optional)

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one

Body (JSON)

{
  "date_of_birth": "1990-08-13"
}

Numerology compatibility

POST/v1/numerology/compatibility

1 credit · Secret key (test or live) · getNumerologyCompatibility · Page for this operation

Request body

person_a NameDob required
- name string
  at least 1 characters · at most 120 characters
- date_of_birth string (date) required
  e.g. "1990-08-13"
No other fields are accepted.
person_b NameDob required
- name string
  at least 1 characters · at most 120 characters
- date_of_birth string (date) required
  e.g. "1990-08-13"
No other fields are accepted.

No other fields are accepted.

Response

JSON { data, meta, warnings }, where data is:

score integer required
≥ 0 · ≤ 100
relation string required
person_a CoreNumbers required
- life_path integer required
- birth integer required
- destiny integer or null required
  One of:
  1. integer
  2. null
person_b CoreNumbers required
- life_path integer required
- birth integer required
- destiny integer or null required
  One of:
  1. integer
  2. null
scores object required
- life_path integer required
- birth integer required
- destiny integer or null required
  One of:
  1. integer
  2. null
verdict string required
guidance string required

Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.

Example request

curl -X POST 'https://api.astrologics.in/v1/numerology/compatibility' \
  -H 'Authorization: Bearer al_test_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"person_a":{"name":"Asha","date_of_birth":"1990-08-13"},"person_b":{"name":"Ravi","date_of_birth":"1992-03-02"}}'

Node.js

const res = await fetch("https://api.astrologics.in/v1/numerology/compatibility", {
  method: "POST",
  headers: { Authorization: "Bearer al_test_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    "person_a": {
      "name": "Asha",
      "date_of_birth": "1990-08-13"
    },
    "person_b": {
      "name": "Ravi",
      "date_of_birth": "1992-03-02"
    }
  }),
});
console.log(JSON.stringify(await res.json(), null, 2));

Python

import json
import urllib.error
import urllib.request

body = {
    "person_a": {
        "name": "Asha",
        "date_of_birth": "1990-08-13",
    },
    "person_b": {
        "name": "Ravi",
        "date_of_birth": "1992-03-02",
    },
}

req = urllib.request.Request(
    "https://api.astrologics.in/v1/numerology/compatibility",
    method="POST",
    headers={"Authorization": "Bearer al_test_YOUR_KEY", "Content-Type": "application/json"},
    data=json.dumps(body).encode(),
)
try:
    with urllib.request.urlopen(req) as res:
        print(json.dumps(json.load(res), indent=2, ensure_ascii=False))
except urllib.error.HTTPError as err:
    print(err.code, err.read().decode())

PHP

<?php
$ch = curl_init('https://api.astrologics.in/v1/numerology/compatibility');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"person_a":{"name":"Asha","date_of_birth":"1990-08-13"},"person_b":{"name":"Ravi","date_of_birth":"1992-03-02"}}',
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 679 characters

{
  "data": {
    "score": 62,
    "relation": "enemy",
    "person_a": {
      "life_path": 4,
      "birth": 4,
      "destiny": 1
    },
    "person_b": {
      "life_path": 8,
      "birth": 2,
      "destiny": 1
    },
    "scores": {
      "life_path": 25,
      "birth": 60,
      "destiny": 100
    },
    "verdict": "Good, workable match",
    "guidance": "Your core numbers pull in different directions; with awareness and respect for each other's nature, the friction can become balance."
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.10.10",
    "mode": "live",
    "credits_charged": 1
  },
  "warnings": []
}

Try it

Test key (optional)

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one

Body (JSON)

{
  "person_a": {
    "name": "Asha",
    "date_of_birth": "1990-08-13"
  },
  "person_b": {
    "name": "Ravi",
    "date_of_birth": "1992-03-02"
  }
}

Business name number (Chaldean): planet, verdict and the business-friendly numbers

POST/v1/numerology/business-name

1 credit · Secret key (test or live) · getBusinessNameNumber · Page for this operation

Request body

name string required
at least 1 characters · at most 120 characters

No other fields are accepted.

Response

JSON { data, meta, warnings }, where data is:

business_number integer required
compound_total integer required
planet string required
favourable boolean required
verdict string required
note string required
best_numbers array of integer required
tip string required

Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.

Example request

curl -X POST 'https://api.astrologics.in/v1/numerology/business-name' \
  -H 'Authorization: Bearer al_test_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Asha Verma Designs"}'

Node.js

const res = await fetch("https://api.astrologics.in/v1/numerology/business-name", {
  method: "POST",
  headers: { Authorization: "Bearer al_test_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    "name": "Asha Verma Designs"
  }),
});
console.log(JSON.stringify(await res.json(), null, 2));

Python

import json
import urllib.error
import urllib.request

body = {
    "name": "Asha Verma Designs",
}

req = urllib.request.Request(
    "https://api.astrologics.in/v1/numerology/business-name",
    method="POST",
    headers={"Authorization": "Bearer al_test_YOUR_KEY", "Content-Type": "application/json"},
    data=json.dumps(body).encode(),
)
try:
    with urllib.request.urlopen(req) as res:
        print(json.dumps(json.load(res), indent=2, ensure_ascii=False))
except urllib.error.HTTPError as err:
    print(err.code, err.read().decode())

PHP

<?php
$ch = curl_init('https://api.astrologics.in/v1/numerology/business-name');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"name":"Asha Verma Designs"}',
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 648 characters

{
  "data": {
    "business_number": 7,
    "compound_total": 52,
    "planet": "ketu",
    "favourable": false,
    "verdict": "Not ideal for business",
    "note": "Spiritual/research vibration (Ketu); less ideal for pure commercial ventures.",
    "best_numbers": [
      1,
      3,
      5,
      6,
      9
    ],
    "tip": "Consider a spelling that totals 1, 3, 5, 6 or 9 — the most business-friendly numbers — ideally matched to the owner's life-path number."
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.10.10",
    "mode": "live",
    "credits_charged": 1
  },
  "warnings": []
}

Try it

Test key (optional)

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one

Body (JSON)

{
  "name": "Asha Verma Designs"
}

Is the name lucky for the person: the name number against the life path and birth numbers

POST/v1/numerology/lucky-name

1 credit · Secret key (test or live) · getLuckyName · Page for this operation

Request body

name string required
at least 1 characters · at most 120 characters
date_of_birth string (date) required
e.g. "1990-08-13"

No other fields are accepted.

Response

JSON { data, meta, warnings }, where data is:

name_number integer required
life_path_number integer required
birth_number integer required
relation_to_life_path string required
relation_to_birth string required
score number required
≥ 0 · ≤ 100
lucky boolean required
verdict string required
advice string required

Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.

Example request

curl -X POST 'https://api.astrologics.in/v1/numerology/lucky-name' \
  -H 'Authorization: Bearer al_test_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Asha Verma","date_of_birth":"1990-08-13"}'

Node.js

const res = await fetch("https://api.astrologics.in/v1/numerology/lucky-name", {
  method: "POST",
  headers: { Authorization: "Bearer al_test_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    "name": "Asha Verma",
    "date_of_birth": "1990-08-13"
  }),
});
console.log(JSON.stringify(await res.json(), null, 2));

Python

import json
import urllib.error
import urllib.request

body = {
    "name": "Asha Verma",
    "date_of_birth": "1990-08-13",
}

req = urllib.request.Request(
    "https://api.astrologics.in/v1/numerology/lucky-name",
    method="POST",
    headers={"Authorization": "Bearer al_test_YOUR_KEY", "Content-Type": "application/json"},
    data=json.dumps(body).encode(),
)
try:
    with urllib.request.urlopen(req) as res:
        print(json.dumps(json.load(res), indent=2, ensure_ascii=False))
except urllib.error.HTTPError as err:
    print(err.code, err.read().decode())

PHP

<?php
$ch = curl_init('https://api.astrologics.in/v1/numerology/lucky-name');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"name":"Asha Verma","date_of_birth":"1990-08-13"}',
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 545 characters

{
  "data": {
    "name_number": 1,
    "life_path_number": 4,
    "birth_number": 4,
    "relation_to_life_path": "neutral",
    "relation_to_birth": "neutral",
    "score": 60,
    "lucky": true,
    "verdict": "Your name is favourable for you",
    "advice": "Your name number harmonises with your core numbers — keep it as it is; it supports your natural path."
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.10.10",
    "mode": "live",
    "credits_charged": 1
  },
  "warnings": []
}

Try it

Test key (optional)

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one

Body (JSON)

{
  "name": "Asha Verma",
  "date_of_birth": "1990-08-13"
}