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
| Option | Values | Default | What it does |
|---|---|---|---|
zodiaque | tropical, vedique, les_deux | tropical | "tropical" (Western synastry, the default), "vedique" (both people's Vedic charts, side by side) or "les_deux". |
cartes | a list among D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D16, D20, D24, D27, D30, D40, D45, D60, toutes | empty | In 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=enWith 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:
| Key | Type |
|---|---|
personnes | array |
tropical | object |
vedique | object |
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
- Compute a chart
calculer_theme - Vimshottari dashas
dashas - A chart's transits
transits - The solar return
revolution_solaire - The sky of a date
ciel - The sky calendar
calendrier - A sign's horoscope
horoscope - The site's texts
textes_du_site - Search the site
chercher_sur_le_site
← The API v1 tools: Vega’s calculations, in JSONAll the documentation for assistants and developersOpenAPI