API v1 · developers and assistants · dashas

Vimshottari dashas

The Vimshottari periods (Vedic astrology) of a chart, calculated by the site from the Moon's nakshatra: the current major and sub-period, the next one, then the dated major periods and their sub-periods over a range.

What it takes

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

Options

Option	Values	Default	What it does
`debut`	a date YYYY-MM-DD, or empty	empty	Start of the range, YYYY-MM-DD; "": today.
`fin`	a date YYYY-MM-DD, or empty	empty	End of the range, YYYY-MM-DD; "": ten years after the start.
`detail`	`sous_periodes`, `grandes_periodes`	`sous_periodes`	"sous_periodes" (major periods and their sub-periods, the default) or "grandes_periodes" (major periods only).

Calling it

With GET

https://montheme.fr/api/v1/dashas?date=1990-05-12&heure=14:30&ville=Lyon&pays=FR&prenom=Camille&detail=grandes_periodes&lang=en

With POST and a JSON body

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

{
  "naissance": {
    "date": "1990-05-12",
    "heure": "14:30",
    "ville": "Lyon",
    "pays": "FR",
    "prenom": "Camille"
  },
  "detail": "grandes_periodes",
  "lang": "en"
}

With the MCP server (tool `dashas`)

https://montheme.fr/api/mcp

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "dashas",
    "arguments": {
      "birth": {
        "date": "1990-05-12",
        "time": "14:30",
        "city": "Lyon",
        "country": "FR",
        "name": "Camille"
      },
      "detail": "grandes_periodes",
      "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
`systeme`	string
`nakshatraDeLaLune`	object
`enCours`	object \| null
`sousPeriodeSuivante`	object \| null
`debut`	string
`fin`	string
`periodes`	array

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

{
  "outil": "dashas",
  "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": {
    "systeme": "vimshottari",
    "nakshatraDeLaLune": {
      "nom": "Jyeshtha",
      "pada": 4,
      "maitre": "mercure",
      "divinite": "Indra"
    },
    "enCours": {
      "grandePeriode": "lune",
      "sousPeriode": "lune",
      "debut": "2026-09-15",
      "fin": "2027-07-16",
      "finGrandePeriode": "2036-09-15"
    },
    "sousPeriodeSuivante": {
      "grandePeriode": "lune",
      "sousPeriode": "mars",
      "debut": "2027-07-17"
    },
    "debut": "2026-10-27",
    "fin": "2036-10-27",
    "periodes": [
      {
        "graha": "lune",
        "nom": "Moon",
        "debut": "2026-09-15",
        "fin": "2036-09-15",
        "enCours": true
      },
…

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 dasha calculator.

The other tools

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