Name Correction API
The Name Correction API analyzes the numerology value of a full name against the date of birth and reports how strongly the two are aligned, along with suggested spellings that bring the name into a better vibration. It is ideal for numerology platforms that offer name correction or name suggestion services.
Overview
This API compares the numerology number of the supplied name with the core numbers derived from the date of birth, then returns an alignment percentage, the target number the name should vibrate to, and a set of suggested spellings that reach that target. It also returns ready to display text explaining the result to the end user.
API Endpoint
POST https://astroapi-7.divineapi.com/numerology/v1/name-correction
Returns the name alignment analysis in the response, including the current and target name numbers, an alignment percentage and suggested name spellings.
Headers
| Name | Type | Description |
|---|---|---|
| Authorization* | String | Your API Access Token (e.g. Bearer {token}) |
Request Body
| Name | Type | Description |
|---|---|---|
| api_key* | String | Your DivineAPI key |
| day* | Integer | Date of birth (e.g. 24) |
| month* | Integer | Month of birth (e.g. 05) |
| year* | Integer | Year of birth (e.g. 2023) |
| full_name* | String | Full name (e.g. Rahul Kumar) |
| lan | String | Language code (en or hi, default en) |
200: OK Fetched Name Correction Successfully
{
"status": "success",
"code": 200,
"message": "Request was successful",
"data": {
"name_number": 5,
"life_path_number": 9,
"birthday_number": 6,
"name_alignment_percentage": 57,
"target_name_number": 3,
"is_already_aligned": false,
"suggested_names": [
"RAHUL O KUMAR",
"RAHUL Z KUMAR"
],
"content": {
"heading": "Alignment Upgrade Available",
"description": "Dear Rahul Kumar, your present name vibrates to number 5 and sits at 57% alignment with your birth energy, a balanced but under-powered position. Your name is neither hurting nor strongly helping you, so a good deal of potential is left untapped. The good news is that a better-aligned number is available to you. By tuning your name to number 3, you can move from this neutral footing to a genuinely supportive vibration that adds welcome momentum to your career, finances and relationships. Because your starting point is already stable, only a light spelling adjustment is needed to make this upgrade, and it can be done with minimal change to how your name looks and sounds.",
"advice": "Adopt one of RAHUL O KUMAR, RAHUL Z KUMAR to align your name with the stronger number 3 and lift it from neutral into clearly favourable territory."
}
}
}The response includes:
name_number - The numerology number of the name supplied in full_name.
life_path_number and birthday_number - Core numbers derived from the date of birth.
name_alignment_percentage - How closely the current name aligns with the birth energy, from 0 to 100.
target_name_number - The number the name should vibrate to for the strongest alignment.
is_already_aligned - Returns true when the current name already matches the target number.
suggested_names - Alternative spellings of the supplied name that reach the target number.
content - A heading, description and advice string, written for direct display to the end user.
Example Code Implementations
Below are example implementations in various programming environments.
cURL
curl --location 'https://astroapi-7.divineapi.com/numerology/v1/name-correction' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'day="24"' \
--form 'month="05"' \
--form 'year="2023"' \
--form 'full_name="Rahul Kumar"' \
--form 'lan="en"'NodeJS
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://astroapi-7.divineapi.com/numerology/v1/name-correction',
'headers': {
'Authorization': 'Bearer {Your Auth Token}'
},
formData: {
'api_key': '{Your API Key}',
'day': '24',
'month': '05',
'year': '2023',
'full_name': 'Rahul Kumar',
'lan': 'en'
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
JavaScript jQuery AJAX
var form = new FormData();
form.append("api_key", "{Your API Key}");
form.append("day", "24");
form.append("month", "05");
form.append("year", "2023");
form.append("full_name", "Rahul Kumar");
form.append("lan", "en");
var settings = {
"url": "https://astroapi-7.divineapi.com/numerology/v1/name-correction",
"method": "POST",
"timeout": 0,
"headers": {
"Authorization": "Bearer {Your Auth Token}"
},
"processData": false,
"mimeType": "multipart/form-data",
"contentType": false,
"data": form
};
$.ajax(settings).done(function (response) {
console.log(response);
});Python
import requests
url = "https://astroapi-7.divineapi.com/numerology/v1/name-correction"
payload = {'api_key': '{Your API Key}',
'day': '24',
'month': '05',
'year': '2023',
'full_name': 'Rahul Kumar',
'lan': 'en'}
headers = {
'Authorization': 'Bearer {Your Auth Token}'
}
response = requests.request("POST", url, headers=headers, data=payload,)
print(response.text)
Implementation Notes
Displaying the result:
Use the content.heading, content.description and content.advice fields directly in your interface. They are written for end users and need no post-processing.
Presenting suggestions:suggested_names lists alternative spellings that reach target_name_number. Offer them as options rather than as a single mandated change.
Skip when already aligned:
When is_already_aligned is true, no correction is required. Show a confirmation instead of suggestions.
Security:
Always keep your api_key and Bearer token on the server side; never expose them in client applications.