Numerology API - DivineAPI

Free Numerology API for developers. 15+ REST endpoints covering life path, destiny, soul urge and personality numbers, Loshu grid, Chaldean numerology, yearly predictions and mobile number analysis. Plain JSON over HTTPS, 25 languages, no SDK required.

---

What is the Numerology API?

The Numerology API by DivineAPI is a suite of 15+ REST endpoints for numerology calculations. Give a full name and birth date, get back the complete numerology profile: life path, expression/destiny, soul urge, personality, birthday numbers, plus Loshu grid patterns, Chaldean-system readings, yearly predictions, gemstone remedies and mobile-number analysis. Plain JSON over HTTPS, 25 languages, no SDK required.

Part of the broader DivineAPI platform (300+ astrology, horoscope, tarot and numerology endpoints).

Why choose DivineAPI's Numerology API?

• 15+ REST endpoints covering Pythagorean and Chaldean numerology
• Core Numbers in one call: life path, expression, soul urge, personality, birthday
• Loshu (magic square) grid analysis with missing-number and repeating-number insights
• Mobile number analysis and new-number suggestions based on birth data
• Yearly predictions and gemstone recommendations grounded in numerology
• 25-language output: English, Hindi, Spanish, French, Arabic, Chinese, and more
• No SDK lock-in: plain JSON over HTTPS, works with every language
• Live status page: uptime monitored at status.divineapi.com

All endpoints in the Numerology API

Core Numerology Profile

Endpoint	Docs
Core Numbers	link
Name Number	link
Birthday Number	link

Loshu Grid & Number Patterns

Endpoint	Docs
Loshu Grid	link
Missing Numbers	link
Repeating Numbers	link
Driver and Conductor Number	link

Number Arrows & Insights

Endpoint	Docs
Two Number Arrow	link
Three Number Arrow	link
Zodiac Planet Number	link

Predictions & Remedies

Endpoint	Docs
Luck Numerology	link
Yearly Prediction	link
Gemstone Suggestion	link

Mobile Numerology

Endpoint	Docs
New Mobile Number	link
Analyze Mobile Number	link

Full reference, request/response samples, and live "try-it" console → developers.divineapi.com/numerology-apis

---

Quick start

1. Get your API key → divineapi.com/register (14-day free trial, no credit card)
2. Make your first call - see the walkthrough below
3. Browse all endpoints → developers.divineapi.com/numerology-apis

---

Walkthrough: Core Numbers

The flagship endpoint. Submit a name and birth date, get back all core numerology numbers (life path, expression, soul urge, personality, birthday) in a single call, each with a full interpretive description.

POST https://astroapi-4.divineapi.com/numerology/v1/core-numbers

Authenticate with a Bearer token in the Authorization header and pass api_key in the request body (both required).

Request body

Parameter	Type	Required	Description	Example
api_key	string	✓	Your DivineAPI key	YOUR_API_KEY
full_name	string	✓	Name to analyze	Amit Kumar
day	integer	✓	Date of birth (day)	24
month	integer	✓	Month of birth	5
year	integer	✓	Year of birth	1990
gender	string	✓	Gender	male
method	string	✓	Numerology system: chaldean or pythagorean	chaldean
lan	string	-	Language code (default en)	en

Full docs → developers.divineapi.com/numerology-apis/core-numbers

Sample response

{
  "success": 1,
  "data": {
    "life_path_number": {
      "name": "Life Path Number",
      "number": 9,
      "description": "As a Life Path 9, you are a natural humanitarian. You possess a deep concern for the well-being of others, often driven by empathy and compassion..."
    },
    "expression_number": {
      "name": "Expression Number",
      "number": 5,
      "description": "..."
    },
    "soul_urge_number": {
      "name": "Soul Urge Number",
      "number": 3,
      "description": "..."
    },
    "personality_number": {
      "name": "Personality Number",
      "number": 2,
      "description": "..."
    },
    "birthday_number": {
      "name": "Birthday Number",
      "number": 6,
      "description": "..."
    }
    // ... plus maturity number, balance number, heart's desire and more
  }
}

---

Code examples

cURL

curl -X POST "https://astroapi-4.divineapi.com/numerology/v1/core-numbers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "api_key=YOUR_API_KEY" \
  --data-urlencode "full_name=Amit Kumar" \
  --data-urlencode "day=24" \
  --data-urlencode "month=5" \
  --data-urlencode "year=1990" \
  --data-urlencode "gender=male" \
  --data-urlencode "method=chaldean"

Python (requests)

import requests

url = "https://astroapi-4.divineapi.com/numerology/v1/core-numbers"

headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/x-www-form-urlencoded",
}

payload = {
    "api_key":   "YOUR_API_KEY",
    "full_name": "Amit Kumar",
    "day":       24,
    "month":     5,
    "year":      1990,
    "gender":    "male",
    "method":    "chaldean",
}

response = requests.post(url, headers=headers, data=payload)
print(response.json())

JavaScript (browser, fetch)

const url = "https://astroapi-4.divineapi.com/numerology/v1/core-numbers";

const body = new URLSearchParams({
  api_key:   "YOUR_API_KEY",
  full_name: "Amit Kumar",
  day: 24, month: 5, year: 1990,
  gender: "male",
  method: "chaldean",
});

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type":  "application/x-www-form-urlencoded",
  },
  body,
});

const data = await response.json();
console.log(data);

Node.js (fetch, Node 18+)

// Node.js 18+ ships with fetch built-in, no dependencies needed.

async function getCoreNumbers() {
  const url = "https://astroapi-4.divineapi.com/numerology/v1/core-numbers";

  const body = new URLSearchParams({
    api_key:   "YOUR_API_KEY",
    full_name: "Amit Kumar",
    day: 24, month: 5, year: 1990,
    gender: "male",
    method: "chaldean",
  });

  const res = await fetch(url, {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type":  "application/x-www-form-urlencoded",
    },
    body,
  });

  const data = await res.json();
  console.log(data);
}

getCoreNumbers();

PHP (curl)

<?php
$url = "https://astroapi-4.divineapi.com/numerology/v1/core-numbers";

$payload = http_build_query([
    "api_key"   => "YOUR_API_KEY",
    "full_name" => "Amit Kumar",
    "day"       => 24,
    "month"     => 5,
    "year"      => 1990,
    "gender"    => "male",
    "method"    => "chaldean",
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_KEY",
    "Content-Type: application/x-www-form-urlencoded",
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

Go (net/http)

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    endpoint := "https://astroapi-4.divineapi.com/numerology/v1/core-numbers"

    form := url.Values{}
    form.Set("api_key",   "YOUR_API_KEY")
    form.Set("full_name", "Amit Kumar")
    form.Set("day",       "24")
    form.Set("month",     "5")
    form.Set("year",      "1990")
    form.Set("gender",    "male")
    form.Set("method",    "chaldean")

    req, _ := http.NewRequest("POST", endpoint, strings.NewReader(form.Encode()))
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Content-Type",  "application/x-www-form-urlencoded")

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

---

Other APIs by DivineAPI

---

Resources

• Full documentation → developers.divineapi.com/numerology-apis
• Parent platform README → github.com/DivineAPI/astrology-api
• API status → status.divineapi.com
• Postman collection → Run in Postman
• Changelog → developers.divineapi.com/changelog
• Support → admin@divineapi.com

---

License & Usage

Code samples on this page are free to copy into your own projects, no attribution required. Marketing copy, logos, and the DivineAPI name are © 2026 DivineAPI, all rights reserved.

For the terms that govern the API service itself, see divineapi.com/terms.

Contact

Questions, feature requests or partnership enquiries → admin@divineapi.com