API v1 · developers and assistants · numerologie

The numerology chart

Calculates a full numerology chart with the site (Pythagorean method, master numbers 11, 22 and 33 kept): life path, expression, soul urge, personality, active number, hereditary number, birthday, maturity, inclusion grid, karmic lessons and debts, three cycles, four pinnacles, challenges, personal year, and the planet of the life path. For the chart the person declared as theirs, pass its identifier (`profil`); for anyone else, their birth first names, birth surname and date, as written.

What it takes

No birth: only the options below.

Options

Option	Values	Default	What it does
`prenoms`	a text	empty	All birth first names, in birth-certificate order ("Camille Louise"); "" with a profile.
`nom`	a text	empty	The birth surname (maiden name); "" with a profile.
`prenom_usuel`	a text	empty	The first name used day to day if it is not the first one (it gives the active number); "" otherwise.
`date`	a date YYYY-MM-DD, or empty	empty	The birth date, YYYY-MM-DD; "" with a profile.
`annee`	an integer	`0`	The year of the requested personal year; 0: the current year.

Calling it

With GET

https://montheme.fr/api/v1/numerologie?prenoms=Camille+Louise&nom=Martin&date=1990-05-12&annee=2027&lang=en

With POST and a JSON body

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

{
  "prenoms": "Camille Louise",
  "nom": "Martin",
  "date": "1990-05-12",
  "annee": 2027,
  "lang": "en"
}

With the MCP server (tool `numerologie`)

https://montheme.fr/api/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "numerologie",
    "arguments": {
      "prenoms": "Camille Louise",
      "nom": "Martin",
      "date": "1990-05-12",
      "annee": 2027,
      "language": "en"
    }
  }
}

What it returns

The response holds outil, version, and resultat, whose keys are:

Key	Type
`methode`	string
`nombres`	object
`grilleInclusion`	object
`leconsKarmiques`	array
`nombreDominant`	array
`dettesKarmiques`	array
`cycles`	array
`realisations`	array
`defis`	array
`anneePersonnelle`	object
`planeteDuCheminDeVie`	object
`pages`	object

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

{
  "outil": "numerologie",
  "version": "1",
  "partage": {
    "lien": "https://montheme.fr/en/numerology/numerology-chart-calculator?prenoms=Camille+Louise&nom=Martin&date=1990-05-12"
  },
  "resultat": {
    "methode": "pythagoricienne",
    "nombres": {
      "cheminDeVie": {
        "valeur": 9,
        "total": 27,
        "maitre": false,
        "detteKarmique": null,
        "motsCles": "Ideals, generosity, completion",
        "page": "https://montheme.fr/en/numerology/number-9"
      },
      "expression": {
        "valeur": 4,
        "total": 85,
        "maitre": false,
        "detteKarmique": 13,
        "motsCles": "Structure, work, loyalty",
        "page": "https://montheme.fr/en/numerology/number-4"
      },
      "intime": {
        "valeur": 3,
        "total": 48,
        "maitre": false,
        "detteKarmique": null,
        "motsCles": "Expression, joy, creativity",
        "page": "https://montheme.fr/en/numerology/number-3"
      },
      "realisation": {
        "valeur": 1,
        "total": 37,
…

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 numerology chart calculator.

The other tools

← The API v1 tools: Vega’s calculations, in JSON All the documentation for assistants and developers OpenAPI