API v1 · developers and assistants · compatibilite

Two charts' compatibility

Two charts' compatibility, calculated by the site: cross aspects with orbs, star scores 1 to 5 (love, communication, longevity, passion, overall), strengths, levers and the reading of the bond; in Vedic, both people's charts side by side (D1 and D9 by default, or those asked) and each Moon's nakshatra, to cross.

What it takes

Two births: date1, heure1, ville1… and date2, heure2, ville2… with GET; personne1 and personne2 in JSON.

Options

OptionValuesDefaultWhat it does
zodiaquetropical, vedique, les_deuxtropical"tropical" (Western synastry, the default), "vedique" (both people's Vedic charts, side by side) or "les_deux".
cartesa list among D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D16, D20, D24, D27, D30, D40, D45, D60, toutesemptyIn Vedic: each person's charts ("D9" for the bond, "D7" for children…, "toutes"); the D1 always; []: the D1 and the D9.

Calling it

With GET

https://montheme.fr/api/v1/compatibilite?date1=1990-05-12&heure1=14:30&ville1=Lyon&pays1=FR&prenom1=Camille&date2=1992-11-03&heure2=08:15&ville2=Bordeaux&pays2=FR&prenom2=Hugo&zodiaque=les_deux&cartes=D9&lang=en

With POST and a JSON body

POST https://montheme.fr/api/v1/compatibilite
Content-Type: application/json

{
  "personne1": {
    "date": "1990-05-12",
    "heure": "14:30",
    "ville": "Lyon",
    "pays": "FR",
    "prenom": "Camille"
  },
  "personne2": {
    "date": "1992-11-03",
    "heure": "08:15",
    "ville": "Bordeaux",
    "pays": "FR",
    "prenom": "Hugo"
  },
  "zodiaque": "les_deux",
  "cartes": [
    "D9"
  ],
  "lang": "en"
}

With the MCP server (tool compatibilite)

https://montheme.fr/api/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "compatibilite",
    "arguments": {
      "person1": {
        "date": "1990-05-12",
        "time": "14:30",
        "city": "Lyon",
        "country": "FR",
        "name": "Camille"
      },
      "person2": {
        "date": "1992-11-03",
        "time": "08:15",
        "city": "Bordeaux",
        "country": "FR",
        "name": "Hugo"
      },
      "zodiaque": "les_deux",
      "cartes": [
        "D9"
      ],
      "language": "en"
    }
  }
}

What it returns

The response holds outil, version, partage.lien (the chart’s page on the site, to give to the person), and resultat, whose keys are:

KeyType
personnesarray
tropicalobject
vediqueobject

What this example returns (the start), calculated by the site when the page was built:

{
  "outil": "compatibilite",
  "version": "1",
  "partage": {
    "lien": "https://montheme.fr/en/synastry/calculator?date1=1990-05-12&heure1=14%3A30&ville1=Lyon&pays1=FR&prenom1=Camille&date2=1992-11-03&heure2=08%3A15&ville2=Bordeaux&pays2=FR&prenom2=Hugo"
  },
  "resultat": {
    "zodiaque": "les_deux",
    "personnes": [
      {
        "nom": "Camille",
        "bigThree": {
          "soleil": "Taurus",
          "lune": "Sagittarius",
          "ascendant": "Virgo"
        },
        "venus": "Aries",
        "mars": "Pisces",
        "heureInconnue": false
      },
      {
        "nom": "Hugo",
        "bigThree": {
          "soleil": "Scorpio",
          "lune": "Aquarius",
          "ascendant": "Scorpio"
        },
        "venus": "Sagittarius",
        "mars": "Cancer",
        "heureInconnue": false
      }
    ],
    "tropical": {
      "notes": {
        "amour": 5,
        "communication": 3,
…

Open CORS, no authentication; 60 calls a minute and 2,000 a day per IP address. lang=en for English (keys stay in French).

The same calculation on the site

What this tool calculates, the site also shows the person: the compatibility calculator (synastry).

The other tools

← The API v1 tools: Vega’s calculations, in JSONAll the documentation for assistants and developersOpenAPI