API reference › Numerology

Lucky Name Check API

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

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

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

More in Numerology

Get a free API key Numerology product page