POST/v1/numerology/compatibility

Calculate numerology compatibility

Scores the numerology compatibility of two people from their Life Path numbers, which come from each person's birth date. Each person also sends name (required), which does not change the score. Returns score, level, and explanatory strengths/challenges.

Request parameters

person1required

object

person1.namerequired

string

Name of the person. Required, but it does not change the score: only the birth date does.

person1.daterequired

string (date)

Birth date for compatibility calculation (YYYY-MM-DD)

person2required

object

person2.namerequired

string

Name of the person. Required, but it does not change the score: only the birth date does.

person2.daterequired

string (date)

Birth date for compatibility calculation (YYYY-MM-DD)

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.life_path_1

integer

First person's life path number

data.life_path_2

integer

Second person's life path number

data.compatibility_score

integer

Compatibility score (1-10)

data.compatibility_level

string

Compatibility level (Excellent, Good, Fair, Challenging)

data.interpretation

string

Detailed compatibility interpretation

data.strengths

array[string]

Relationship strengths

data.challenges

array[string]

Potential challenges

data.advice

string

Relationship advice

Errors

api_key_invalid

Invalid API key format.

api_key_missing

API key is missing. Include it in the Authorization header as 'Bearer YOUR_KEY'.

api_key_not_found

The provided API key was not found. Verify the key in your Asterwise dashboard.

api_key_revoked

This API key has been revoked.

burst_limit_exceeded

Too many requests per minute. Please slow down.

internal_error

Something went wrong on our end. Please try again, or contact [email protected] if the problem persists. Include your request_id when contacting support.

ip_rate_limit_exceeded

Too many requests from this IP address. Please slow down.

monthly_usage_limit_exceeded

Monthly API call limit reached. Upgrade your plan to continue.

payload_too_large

Request body exceeds maximum allowed size of 64KB.

subscription_expired

Your subscription has expired. Please renew at asterwise.com/dashboard to continue.

validation_error

The request couldn't be processed. See the 'details' field for specific field-level issues.

Related endpoints

• Generate lucky numbers
• Name Correction Analysis
• Get number meaning by context

Request

POST·application/json

curl

curl -X POST "https://api.asterwise.com/v1/numerology/compatibility" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"person1":{"name":"Arjun Mehta","date":"1985-11-12"},"person2":{"name":"Sofia Rossi","date":"1990-06-21"}}'

Python

import asterwise
from asterwise.api.numerology_api import NumerologyApi
from asterwise.models.compatibility_request import CompatibilityRequest

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

request = CompatibilityRequest(
    person1={'name': 'Arjun Mehta', 'date': '1985-11-12'},
    person2={'name': 'Sofia Rossi', 'date': '1990-06-21'},
)

with asterwise.ApiClient(configuration) as client:
    api = NumerologyApi(client)
    result = api.numerology_compatibility(compatibility_request=request)
    print(result)

TypeScript

import { createClient, createConfig, numerologyCompatibility } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await numerologyCompatibility({
  client,
  body: {
      "person1": {
        "name": "Arjun Mehta",
        "date": "1985-11-12"
      },
      "person2": {
        "name": "Sofia Rossi",
        "date": "1990-06-21"
      }
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "life_path_1": 1,
    "life_path_2": 1,
    "compatibility_score": 7,
    "compatibility_level": "Good",
    "interpretation": "Life Path 1 and 1 have good compatibility. This combination offers opportunities for growth through understanding differ…",
    "strengths": [
      "Shared leadership",
      "Mutual independence",
      "... and 1 more item"
    ],
    "challenges": [
      "Power struggles",
      "Competition",
      "... and 1 more item"
    ],
    "advice": "Focus on your strengths: Shared leadership, Mutual independence. Work together on: Power struggles, Competition."
  }
}