# Numerology Compatibility API

> Numerology Compatibility API. Calculate numerology compatibility between two people using Pythagorean numerology. Accepts two input modes per person:

- Capability page: https://roxyapi.com/apis/numerology-compatibility-api
- Full domain: https://roxyapi.com/products/numerology-api
- OpenAPI spec: https://roxyapi.com/api/v2/numerology/openapi.json
- Remote MCP server: https://roxyapi.com/mcp/numerology

## Overview

Calculate numerology compatibility between two people using Pythagorean numerology. Accepts two input modes per person: pre-calculated Life Path, Expression, and Soul Urge numbers, or raw name and birthdate for automatic calculation. You can mix modes across persons (e.g. numbers for person1, raw inputs for person2). Provides comprehensive relationship analysis with overall compatibility score (0-100), individual aspect compatibility (Life Path 50% weight, Expression 30%, Soul Urge 20%), relationship strengths, challenges, and practical advice. Uses detailed compatibility matrix for all number combinations. Perfect for dating apps, relationship counseling platforms, matchmaking services, and compatibility tools. Get actionable insights for improving relationship dynamics.

## Endpoints

- `POST /api/v2/numerology/compatibility` Calculate Compatibility - Relationship dynamics between two people

## Example request

```bash
curl -X POST "https://roxyapi.com/api/v2/numerology/compatibility" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"person1":{"lifePath":5,"expression":7,"soulUrge":6,"fullName":"John William Smith","year":1990,"month":7,"day":15},"person2":{"lifePath":3,"expression":9,"soulUrge":2,"fullName":"Jane Marie Doe","year":1992,"month":3,"day":22}}'
```

## Example response

```json
{
  "overallScore": 78,
  "rating": "Very Compatible",
  "lifePath": {
    "person1": 5,
    "person2": 3,
    "compatibility": 85,
    "description": "5 and 3 create an exciting dynamic partnership..."
  },
  "expression": {
    "person1": 7,
    "person2": 9,
    "compatibility": 70,
    "description": "7 and 9 share spiritual depth..."
  },
  "soulUrge": {
    "person1": 6,
    "person2": 2,
    "compatibility": 90,
    "description": "6 and 2 have complementary emotional needs..."
  },
  "strengths": [
    "Complementary personalities",
    "Shared values",
    "Mutual growth support",
    "Emotional harmony"
  ],
  "challenges": [
    "Different communication styles",
    "Need for independence vs togetherness",
    "Pace of life differences"
  ],
  "advice": "This relationship thrives on mutual respect and space for individual growth. Focus on..."
}
```

## Remote MCP

Every endpoint is a callable tool on the Remote MCP server at https://roxyapi.com/mcp/numerology over Streamable HTTP. Tool name for `POST /numerology/compatibility`: `post_numerology_compatibility`. `tools/list` is free; `tools/call` bills the same as REST.

## FAQ

### What does the Numerology Compatibility API return?

Calculate numerology compatibility between two people using Pythagorean numerology. Every response is structured JSON with documented fields, not free text, so you map it straight into your product.

### How do I authenticate with the Numerology Compatibility API?

Pass your key in the X-API-Key header on every request. Keys are delivered instantly at checkout with no approval queue. Use a secret sk key server side, or mint a publishable pk key locked to your origins for browser and no-code use.

### Does the Numerology Compatibility API support multiple languages?

Yes. Append the lang query parameter to any endpoint for responses in English, German, Spanish, French, Hindi, Portuguese, Russian and Turkish. The translated payload includes the full interpretation text, not just field labels.

### Is the Numerology Compatibility API available over Remote MCP for AI agents?

Yes. Every endpoint is exposed as a callable tool on the Remote MCP server at https://roxyapi.com/mcp/numerology over Streamable HTTP, so Claude, ChatGPT, Cursor, and any MCP client auto-discover it with no local setup or Docker.

### How is the Numerology Compatibility API billed?

Flat pricing: 1 request equals 1 quota unit, REST and MCP identical, with no credit weighting or per-token markup. Every plan includes all 12 domains, so the Numerology Compatibility API is included at no extra cost.

### What lang values does the Numerology Compatibility API accept?

The lang parameter accepts en, tr, de, es, hi, pt, fr, ru. Case-insensitive where it is a path value.

## Full reference

Fetch the OpenAPI spec at https://roxyapi.com/api/v2/numerology/openapi.json. Master agent manifest at https://roxyapi.com/llms.txt.