# Life-area timing - marriage, career, children, property, foreign, education

Six life areas and one call for all of them. Each answers "when": it cuts a span of up to 20 years into windows wherever a [Vimshottari](/en/vedic/dashas/) period or the sign of Jupiter or Saturn changes, scores every window against the houses and karakas of the area, and returns the rules that fired so your app can show why.

Every rule carries a `basis`: `classical` when a named text states it (BPHS, Phaladeepika), `modern` when it is a 20th-century convention or a widely taught rule for which no verse was found (the double transit, Rahu as karaka of the foreign, Jupiter as karaka of the husband), `kp` for Krishnamurti Paddhati. The points are this API's own and are returned with every response; they rank windows, the rules are the evidence.

**Note:**
No predictions and no text written by a model: a window is a date range, a score and a list of rules. Health and longevity periods are not offered.

## Endpoints

| Endpoint | Credits | Area |
|---|---|---|
| `/v1/vedic/timing/marriage` | 50 | 7th house, its lord, Venus and Jupiter |
| `/v1/vedic/timing/career` | 50 | 10th house, its lord, Sun and Saturn |
| `/v1/vedic/timing/children` | 50 | 5th house, its lord, Jupiter |
| `/v1/vedic/timing/property` | 50 | 4th house, its lord, Mars (land) and Venus (vehicles) |
| `/v1/vedic/timing/foreign` | 50 | 12th and 9th houses, their lords, Rahu |
| `/v1/vedic/timing/education` | 50 | 4th and 5th houses, their lords, Mercury and Jupiter |
| `/v1/vedic/timing/all` | 100 | All six, or the subset in `areas`, from one scan |

## Request

Birth data as for every chart (`date`, `time`, `latitude`, `longitude`, `timezoneOffset` or `timezone`; `ayanamsaId`, Lahiri by default). The houses come from the sidereal Lagna, so the time and the place are required.

| Field | Default | Meaning |
|---|---|---|
| `fromDate` | today | Start of the span, YYYY-MM-DD (UTC) |
| `years` | 5 | Length of the span, 1 to 20 |
| `level` | `pratyantar` (`antar` on `/all`) | Finest dasha level that cuts the windows and is scored |
| `kp` | `false` | Add KP significators from Placidus cusps |
| `minScore` | 1 | Leave out windows below this score |
| `areas` | all | `/all` only: any of `marriage`, `career`, `children`, `property`, `foreign`, `education` |

```bash
curl -X POST https://api.astroway.info/v1/vedic/timing/marriage \
  -H "X-Api-Key: $ASTROWAY_KEY" -H "Content-Type: application/json" \
  -d '{ "date": "1990-05-15", "time": "15:30:00", "timezoneOffset": 3, "latitude": 50.45, "longitude": 30.52, "fromDate": "2026-11-01", "years": 5 }'
```

## Response

`houses` and `karakas` list what the area reads in this chart, with the sign and lord of each house. `windows` are in date order; each has `start`, `end` (UTC dates; `startJd` and `endJd` exact), `dasha` (the maha, antar and pratyantar lords), `transitAtStart`, `score`, `components` (`dasha`, `transit`, `kp`), `convergence` and `rules`. A rule is `{ id, level, planet, house, points, basis, source, rule }`, where `source` is a key into the area's `sources` and `rule` states the fact that fired, for example "Antardasha lord Jupiter rules the 7th house (Pisces)." `summary` gives the number of windows, how many converge, the top score and the five best windows. `rulesBasis.scoring` returns the points below.

Neighbouring windows with the same lords and the same rules are merged, so a sign change of Jupiter that alters nothing does not split a window.

## Rules

| Rule | Points | Basis | Source |
|---|---|---|---|
| `lord-rules-house` | 3 primary house, 1 supporting | classical | BPHS dasha-phala chapters, Phaladeepika ch. 19: a dasha gives the results of the houses its lord rules and occupies |
| `lord-in-house` | 3 primary, 1 supporting | classical | same |
| `lord-aspects-house` | 2, primary houses only | classical | BPHS graha drishti: all aspect the 7th, Mars also the 4th and 8th, Jupiter the 5th and 9th, Saturn the 3rd and 10th |
| `karaka` | 2 classical karaka, 1 modern | per karaka | BPHS ch. 32, Phaladeepika ch. 2, or a modern convention |
| `node-dispositor` | 2, primary houses | modern | Rahu and Ketu give the results of the lord of their sign: widely taught, no verse found |
| `double-transit-house` | 4 | modern | K.N. Rao: Jupiter and Saturn both occupy or aspect the house |
| `double-transit-lord` | 3 | modern | K.N. Rao: both occupy or aspect the sign where the house lord sits |
| `kp-significator` | 1 per house of the KP group | kp | KP Readers: star lord's houses, then the planet's own |

Dasha points are multiplied by the level weight: maha 1, antar 1, pratyantar 0.5. Houses are whole signs from the sidereal Lagna; transits are by sidereal sign. `convergence` is true when a maha or antar rule touches a primary house or a karaka and a double transit fires in the same window: K.N. Rao's "the dasha promises, the transit times".

## Areas

| Area | Primary houses | Supporting | Karakas | KP group |
|---|---|---|---|---|
| marriage | 7 (classical, BPHS ch. 18) | 2, 11 (modern) | Venus (classical, BPHS ch. 32), Jupiter (modern) | 2, 7, 11 |
| career | 10 (classical, BPHS ch. 21) | 6, 11, 2 (modern) | Sun, Saturn (classical, BPHS ch. 32) | 2, 6, 10, 11 |
| children | 5 (classical, BPHS ch. 16) | 9 (modern, bhavat bhavam) | Jupiter (classical) | 2, 5, 11 |
| property | 4 (classical, BPHS ch. 15) | 11 (modern) | Mars, Venus (classical, Phaladeepika ch. 2) | 4, 11, 12 |
| foreign | 12, 9 (modern) | 3 (modern) | Rahu (modern) | 3, 9, 12 |
| education | 5 (classical), 4 (modern) | 9 (modern) | Mercury, Jupiter (classical, Phaladeepika ch. 2) | 4, 9, 11 |

BPHS chapter numbers follow the Santhanam translation and are given to the chapter, not the verse. BPHS also names Mercury and Jupiter as karakas of the 10th; they are left out of career because Jupiter is karaka of five houses and would fire in every area.

## Worked example

Kyiv, 15 May 1990, 15:30 (UTC+3). Virgo Lagna, so the 7th is Pisces and its lord is Jupiter, which sits in Gemini. The marriage window from 17 February 2029 runs Jupiter maha, Jupiter antar, Ketu pratyantar, with Jupiter in Libra and Saturn in Aries:

- maha Jupiter rules the 7th: 3, and is a karaka (modern): 1
- antar Jupiter, the same: 3 + 1
- pratyantar Ketu occupies Cancer, the 11th (supporting): 1 x 0.5
- Jupiter in Libra aspects its 9th, Gemini; Saturn in Aries aspects its 3rd, Gemini: both reach the 7th lord, `double-transit-lord` 3

Score 11.5 (dasha 8.5, transit 3), `convergence` true. The test suite pins this window rule by rule.

## Checked against

No other API publishes the rules behind its timing windows, so there is no number to compare with. The rules are pinned by hand-worked cases in the test suite, and the dasha periods come from the same tree as the Vimshottari endpoints: the antardashas of the mahadasha running at birth count from its notional start, as the texts do.

  - [Dashas](/en/vedic/dashas/): Vimshottari and nine other systems
  - [Muhurat](/en/vedic/muhurat/): The day and hour once the window is known
  - [Matchmaking](/en/vedic/matchmaking/): Porutham, doshas, dasha compatibility
  - [Credits](/en/credits/): Per-endpoint credit cost