API v1 · developers and assistants · transits

A chart's transits

Transits on a chart, the same calculation as the "My transits" page: a day, a week, a month or a date range; slow planets or all. Each pass with its form, orb, whether it is applying, its window and exact pass; natal houses crossed (known birth time).

What it takes

A birth: date (required), heure, ville or lat and lon, pays, tz, prenom.

Options

Option	Values	Default	What it does
`periode`	`jour`, `semaine`, `mois`, `plage`	`semaine`	"jour" (the day's Moon and the fast planets exact that day, over the current slow transits), "semaine" (the default: current major transits, those forming, the week's fast transits, houses crossed, the Nodes), "mois" (slow-planet windows over the month after the start, their exact passes, house ingresses), "plage" (the same from start to end).
`debut`	a date YYYY-MM-DD, or empty	empty	The day, week or start of the period, YYYY-MM-DD; "": today.
`fin`	a date YYYY-MM-DD, or empty	empty	With "plage": the end, YYYY-MM-DD, at most two years after the start; "": three months after.
`planetes`	`toutes`, `lentes`	`toutes`	"toutes" (the default: slow and fast planets, the Moon for a day) or "lentes" (Jupiter to Pluto only).

Calling it

With GET

https://montheme.fr/api/v1/transits?date=1990-05-12&heure=14:30&ville=Lyon&pays=FR&prenom=Camille&periode=mois&debut=2027-01-01&planetes=lentes&lang=en

With POST and a JSON body

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

{
  "naissance": {
    "date": "1990-05-12",
    "heure": "14:30",
    "ville": "Lyon",
    "pays": "FR",
    "prenom": "Camille"
  },
  "periode": "mois",
  "debut": "2027-01-01",
  "planetes": "lentes",
  "lang": "en"
}

With the MCP server (tool `transits`)

https://montheme.fr/api/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "transits",
    "arguments": {
      "birth": {
        "date": "1990-05-12",
        "time": "14:30",
        "city": "Lyon",
        "country": "FR",
        "name": "Camille"
      },
      "periode": "mois",
      "debut": "2027-01-01",
      "planetes": "lentes",
      "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
`periode`	string
`debut`	string
`fin`	string
`heureConnue`	boolean

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

{
  "outil": "transits",
  "version": "1",
  "partage": {
    "lien": "https://montheme.fr/en/birth-chart/result?date=1990-05-12&heure=14%3A30&ville=Lyon&pays=FR&prenom=Camille"
  },
  "resultat": {
    "periode": "mois",
    "debut": "2027-01-01",
    "fin": "2027-02-01",
    "heureConnue": true,
    "fenetres": [
      {
        "forme": "Saturn square Jupiter",
        "transitId": "saturne",
        "aspect": "carre",
        "natal": "jupiter",
        "debut": "2027-01-01",
        "fin": "2027-01-29",
        "exacts": [
          "2027-01-14"
        ],
        "dejaEnCours": true
      },
      {
        "forme": "Pluto trine Midheaven",
        "transitId": "pluton",
        "aspect": "trigone",
        "natal": "mc",
        "debut": "2027-01-01",
        "fin": "2027-02-01",
        "exacts": [],
        "dejaEnCours": true
      },
      {
        "forme": "Saturn conjunction Venus",
…

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 current transits.

The other tools

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