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 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.
Endpoints
Section titled “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
Section titled “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 |
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
Section titled “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.
| 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”.
| 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
Section titled “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-lord3
Score 11.5 (dasha 8.5, transit 3), convergence true. The test suite pins this window rule by rule.
Checked against
Section titled “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.