Skip to content

Getting Started with NumerologyAPI

This guide walks you through:

  • creating a developer account
  • generating an API key
  • understanding authentication
  • making your first API request

NumerologyAPI provides 203+ production-ready endpoints covering:

  • numerology calculations
  • astrology insights
  • zodiac compatibility
  • angel numbers
  • birth chart interpretations

All endpoints support multi-language responses.

1. Create Your Developer Account

The recommended way to access NumerologyAPI is through the official developer platform.

  1. Open the developer dashboard https://dashboard.numerologyapi.com

  2. Create your account

  3. Generate an API key for your organization

  4. Top up credits to your wallet (pay-as-you-go billing)

Your API key will look similar to:

tnea_xxxxxxxxxxxxxxxxx

2. Base URL

All requests are sent to the NumerologyAPI gateway.

Item Value
Base URL https://api.numerologyapi.com/api/v1
Protocol HTTPS
Response Format JSON

Example endpoint:

https://api.numerologyapi.com/api/v1/life_path

3. Authentication

Every request must include your API key.

x-api-key: YOUR_API_KEY

Example request headers:

GET /api/v1/life_path HTTP/1.1
Host: api.numerologyapi.com
x-api-key: YOUR_API_KEY

4. First Request – Life Path Number

GET Request

curl --request GET \
  --url "https://api.numerologyapi.com/api/v1/life_path?birth_year=1990&birth_month=5&birth_day=15" \
  --header "x-api-key: YOUR_API_KEY"

5. POST Variant (JSON Body)

Some endpoints also support POST requests.

curl --request POST \
  --url https://api.numerologyapi.com/api/v1/life_path \
  --header "x-api-key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "birth_year": "1990",
    "birth_month": "5",
    "birth_day": "15"
  }'

6. Language Support

All endpoints support the optional lang parameter.

Example:

?lang=fr

Supported languages:

Code Language
en English
es Spanish
de German
fr French
pt Portuguese

Example request:

/api/v1/life_path?birth_year=1990&birth_month=5&birth_day=15&lang=es

7. Code Examples

Python (requests)

import requests

url = "https://api.numerologyapi.com/api/v1/life_path"

params = {
    "birth_year": 1990,
    "birth_month": 5,
    "birth_day": 15
}

headers = {
    "x-api-key": "YOUR_API_KEY"
}

response = requests.get(url, headers=headers, params=params)

print(response.json())

PHP (cURL)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.numerologyapi.com/api/v1/life_path?birth_year=1990&birth_month=5&birth_day=15",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "x-api-key: YOUR_API_KEY"
  ],
]);

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

echo $response;

?>

JavaScript (Fetch)

const url = new URL("https://api.numerologyapi.com/api/v1/life_path");

url.searchParams.append("birth_year", "1990");
url.searchParams.append("birth_month", "5");
url.searchParams.append("birth_day", "15");

fetch(url, {
    method: "GET",
    headers: {
        "x-api-key": "YOUR_API_KEY"
    }
})
.then(r => r.json())
.then(console.log);

Node.js (axios)

const axios = require("axios");

axios.get("https://api.numerologyapi.com/api/v1/life_path", {
  params: {
    birth_year: 1990,
    birth_month: 5,
    birth_day: 15
  },
  headers: {
    "x-api-key": "YOUR_API_KEY"
  }
})
.then(res => console.log(res.data));

8. Billing Model

NumerologyAPI uses a credit-based billing system.

1 API request = 1 credit
1 USD = 3,921.57 credits

Credits are shared across all 203+ endpoints.

Visit Pricing for full details.

9. RapidAPI Access

The Numerology API is also available on RapidAPI for developers already using that marketplace.

RapidAPI requires these headers:

x-rapidapi-key
x-rapidapi-host

Example endpoint:

https://the-numerology-api.p.rapidapi.com/life_path

Access it here:

https://rapidapi.com/dakidarts-dakidarts-default/api/the-numerology-api

10. Next Steps

Now that you've made your first request:

You are now ready to integrate NumerologyAPI into your application.