Copy page

Copy page as Markdown for LLMs

View as Markdown

View this page as plain text


Open in ChatGPT

Ask ChatGPT about this page

Open in Claude

Ask Claude about this page

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

NameTypeDescription
Authorization*StringYour API Access Token (e.g. Bearer {token})

Request Body

NameTypeDescription
api_key*StringYour DivineAPI key
day*IntegerDate of birth (e.g. 24)
month*IntegerMonth of birth (e.g. 05)
year*IntegerYear of birth (e.g. 2023)
full_name*StringFull name (e.g. Rahul Kumar)
lanStringLanguage 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.

Example Code
curl -X POST "https://astroapi-7.divineapi.com/numerology/v1/name-correction" \
  -H "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"'
const FormData = require('form-data');
const axios = require('axios');

const 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');

const response = await axios.post('https://astroapi-7.divineapi.com/numerology/v1/name-correction', form, {
  headers: {
    ...form.getHeaders(),
    'Authorization': 'Bearer {Your Auth Token}',
  }
});

console.log(response.data);
import requests

url = "https://astroapi-7.divineapi.com/numerology/v1/name-correction"
headers = {
    "Authorization": "Bearer {Your Auth Token}",
}
payload = {
    "api_key": "{Your API Key}",
    "day": "24",
    "month": "05",
    "year": "2023",
    "full_name": "Rahul Kumar",
    "lan": "en",
}

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

print(response.json())
const formData = new FormData();
formData.append('api_key', '{Your API Key}');
formData.append('day', '24');
formData.append('month', '05');
formData.append('year', '2023');
formData.append('full_name', 'Rahul Kumar');
formData.append('lan', 'en');

const response = await fetch('https://astroapi-7.divineapi.com/numerology/v1/name-correction', {
  method: 'POST',
  headers: {
      'Authorization': "Bearer {Your Auth Token}",
    },
  body: formData,
});

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

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('POST', 'https://astroapi-7.divineapi.com/numerology/v1/name-correction', [
    'headers' => [
        'Authorization' => 'Bearer {Your Auth Token}',
    ],
    'multipart' => [
        ['name' => 'api_key', 'contents' => '{Your API Key}'],
        ['name' => 'day', 'contents' => '24'],
        ['name' => 'month', 'contents' => '05'],
        ['name' => 'year', 'contents' => '2023'],
        ['name' => 'full_name', 'contents' => 'Rahul Kumar'],
        ['name' => 'lan', 'contents' => 'en'],
    ],
]);

echo $response->getBody();
package main

import (
    "bytes"
    "fmt"
    "mime/multipart"
    "net/http"
    "io"
)

func main() {
    body := &bytes.Buffer{}
    writer := multipart.NewWriter(body)
    writer.WriteField("api_key", "{Your API Key}")
    writer.WriteField("day", "24")
    writer.WriteField("month", "05")
    writer.WriteField("year", "2023")
    writer.WriteField("full_name", "Rahul Kumar")
    writer.WriteField("lan", "en")
    writer.Close()

    req, _ := http.NewRequest("POST", "https://astroapi-7.divineapi.com/numerology/v1/name-correction", body)
    req.Header.Set("Content-Type", writer.FormDataContentType())
    req.Header.Set("Authorization", "Bearer {Your Auth Token}")

    client := &http.Client{}
    resp, _ := client.Do(req)
    defer resp.Body.Close()

    body2, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body2))
}
import okhttp3.*;
import java.io.IOException;

public class Main {
    public static void main(String[] args) throws IOException {
        OkHttpClient client = new OkHttpClient();

        RequestBody body = new MultipartBody.Builder()
            .setType(MultipartBody.FORM)
            .addFormDataPart("api_key", "{Your API Key}")
            .addFormDataPart("day", "24")
            .addFormDataPart("month", "05")
            .addFormDataPart("year", "2023")
            .addFormDataPart("full_name", "Rahul Kumar")
            .addFormDataPart("lan", "en")
            .build();

        Request request = new Request.Builder()
            .url("https://astroapi-7.divineapi.com/numerology/v1/name-correction")
            .post(body)
            .addHeader("Authorization", "Bearer {Your Auth Token}")
            .build();

        Response response = client.newCall(request).execute();
        System.out.println(response.body().string());
    }
}
import Foundation

let url = URL(string: "https://astroapi-7.divineapi.com/numerology/v1/name-correction")!
var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("Bearer {Your Auth Token}", forHTTPHeaderField: "Authorization")

let boundary = "Boundary-\(UUID().uuidString)"
request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")

var bodyData = Data()
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"api_key\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("{Your API Key}\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"day\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("24\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"month\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("05\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"year\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("2023\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"full_name\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("Rahul Kumar\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)\r\n".data(using: .utf8)!)
bodyData.append("Content-Disposition: form-data; name=\"lan\"\r\n\r\n".data(using: .utf8)!)
bodyData.append("en\r\n".data(using: .utf8)!)
bodyData.append("--\(boundary)--\r\n".data(using: .utf8)!)
request.httpBody = bodyData

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    if let data = data {
        print(String(data: data, encoding: .utf8) ?? "")
    }
}
task.resume()
import okhttp3.*

fun main() {
    val client = OkHttpClient()

    val body = MultipartBody.Builder()
        .setType(MultipartBody.FORM)
        .addFormDataPart("api_key", "{Your API Key}")
        .addFormDataPart("day", "24")
        .addFormDataPart("month", "05")
        .addFormDataPart("year", "2023")
        .addFormDataPart("full_name", "Rahul Kumar")
        .addFormDataPart("lan", "en")
        .build()

    val request = Request.Builder()
        .url("https://astroapi-7.divineapi.com/numerology/v1/name-correction")
        .post(body!!)
        .addHeader("Authorization", "Bearer {Your Auth Token}")
        .build()

    client.newCall(request).execute().use { response ->
        println(response.body?.string())
    }
}
using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program {
    static async Task Main() {
        using var client = new HttpClient();
        client.DefaultRequestHeaders.Add("Authorization", "Bearer {Your Auth Token}");

        var content = new MultipartFormDataContent();
        content.Add(new StringContent("{Your API Key}"), "api_key");
        content.Add(new StringContent("24"), "day");
        content.Add(new StringContent("05"), "month");
        content.Add(new StringContent("2023"), "year");
        content.Add(new StringContent("Rahul Kumar"), "full_name");
        content.Add(new StringContent("en"), "lan");

        var response = await client.PostAsync("https://astroapi-7.divineapi.com/numerology/v1/name-correction", content);
        var result = await response.Content.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}