---
title: "Calculate numerology compatibility"
method: POST
path: "/v1/numerology/compatibility"
tags: ["Numerology"]
---

# Calculate numerology compatibility

`POST /v1/numerology/compatibility`

## Request

- Base URL: `https://api.asterwise.com`
- URL: `https://api.asterwise.com/v1/numerology/compatibility`
- Auth: HTTP bearer

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 body

- CompatibilityRequest
  - `person1` CompatibilityPersonInput, required
    - `name` string, required: Name of the person. Required, but it does not change the score: only the birth date does.
    - `date` string, date, required: Birth date for compatibility calculation (YYYY-MM-DD)
  - `person2` CompatibilityPersonInput, required
    - `name` string, required: Name of the person. Required, but it does not change the score: only the birth date does.
    - `date` string, date, required: Birth date for compatibility calculation (YYYY-MM-DD)

## Response `200`

Numerology compatibility score and interpretation

- AppApiResponseApiResponseCompatibilityResponse2
  - `success` boolean: True if the request succeeded
  - `message` string: Human-readable status message
  - `data` AppApiSchemasNumerologyCompatibilityResponse, required
    - `life_path_1` integer, required: First person's life path number
    - `life_path_2` integer, required: Second person's life path number
    - `compatibility_score` integer, required: Compatibility score (1-10)
    - `compatibility_level` string, required: Compatibility level (Excellent, Good, Fair, Challenging)
    - `interpretation` string, required: Detailed compatibility interpretation
    - `strengths` string[]: Relationship strengths
    - `challenges` string[]: Potential challenges
    - `advice` string, required: Relationship advice

## Other responses

- `401`: Authentication failed
- `403`: Authorization failed
- `404`: Resource not found
- `413`: Payload too large
- `422`: Validation error
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream provider error
- `503`: Service unavailable

---

[API](https://skmtc.dev/asterwise/apis/asterwise-api.md) · [All operations](https://skmtc.dev/asterwise/apis/asterwise-api/llms.txt) · [OpenAPI document](https://skmtc.dev/asterwise/apis/asterwise-api/revisions/e77850f7c569?raw)