POST/v1/numerology/compatibility

Calculate numerology compatibility

Computes compatibility between two people from their numerology signatures. Each person uses name and date (BirthInput-aligned). Requires authenticated API key access (Core tier or above in product terms). Returns score, level, and explanatory strengths/challenges.

Request parameters

person1required

object

person1.namerequired

string

Name of the person in compatibility calculation

person1.daterequired

string (date)

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

person2required

object

person2.namerequired

string

Name of the person in compatibility calculation

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

authentication_failed

Missing or invalid API key.

ephemeris_unavailable

Upstream ephemeris service error.

insufficient_tier

API key tier does not include this endpoint.

internal_error

Unexpected server error.

ip_rate_limit_exceeded

Too many requests in a short window.

payload_too_large

Request body exceeds the size limit.

resource_not_found

Referenced resource was not found.

validation_error

Request body failed schema validation.

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 create a good compatibility match. This combination offers opportunities for growth through understand…",
    "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."
  }
}