Life-area timing: all areas
POST
/vedic/timing/all
curl -X POST https://api.astroway.info/v1/vedic/timing/all \ -H "X-Api-Key: aw_live_..." \ -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, "areas": [ "marriage", "career" ] }'const res = await fetch('https://api.astroway.info/v1/vedic/timing/all', { method: 'POST', headers: { 'X-Api-Key': process.env.ASTROWAY_API_KEY, 'Content-Type': 'application/json', }, body: JSON.stringify({ "date": "1990-05-15", "time": "15:30:00", "timezoneOffset": 3, "latitude": 50.45, "longitude": 30.52, "fromDate": "2026-11-01", "years": 5, "areas": [ "marriage", "career" ] }),});const { ok, data, error } = await res.json();if (!ok) throw new Error(error.message);console.log(data);import os, requests
r = requests.post( 'https://api.astroway.info/v1/vedic/timing/all', headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'}, json={ 'date': "1990-05-15", 'time': "15:30:00", 'timezoneOffset': 3, 'latitude': 50.45, 'longitude': 30.52, 'fromDate': "2026-11-01", 'years': 5, 'areas': [ "marriage", "career" ] },)result = r.json()if not result['ok']: raise RuntimeError(result['error']['message'])print(result['data'])<?phpuse GuzzleHttp\Client;
$client = new Client(['base_uri' => 'https://api.astroway.info/v1/']);$r = $client->post('vedic/timing/all', [ 'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')], 'json' => [ 'date' => '1990-05-15', 'time' => '15:30:00', 'timezoneOffset' => 3, 'latitude' => 50.45, 'longitude' => 30.52, 'fromDate' => '2026-11-01', 'years' => 5, 'areas' => ['marriage', 'career'], ],]);$result = json_decode($r->getBody(), true);if (!$result['ok']) throw new \RuntimeException($result['error']['message']);print_r($result['data']);All six life areas in one call (marriage, career, children, property, foreign, education), or the subset in areas. One chart and one dasha and transit scan shared; each area block equals its own /vedic/timing/{area} route. level defaults to antar here to keep the response small.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Query Parameters
Section titled “Query Parameters ” fields
string
Comma-separated dotted paths, relative to data, to keep in the response. A path is applied to every element of an array, so planets.name means the name of each planet. Paths that match nothing come back in _fields_unmatched; a list where nothing matches at all is a 400, because an empty object would be a confident wrong answer.
Example
planets.name,planets.longitude precision
integer
Round every non-integer number in the response to this many decimal places. Integers are left alone, because an id is not a measurement. Ecliptic longitudes ship with fourteen decimals by default; 2 is about a tenth of an arcminute.
Example
4Header Parameters
Section titled “Header Parameters ” Idempotency-Key
string
Unique per logical operation, kept across retries. For 24 hours from the first request, a repeat with the same key, method, path, body and query string returns the stored response with Idempotent-Replayed: true and costs 0 credits. The same key with a different body or query string is a 409 IDEMPOTENCY_KEY_REUSED; a repeat while the first is still running is a 409 IDEMPOTENCY_IN_PROGRESS. Only 2xx responses are kept. See /idempotency/.
Example
01HXY2A7ZM0ABCDEFRequest Body required
Section titled “Request Body required ” Media type application/json
Birth data and span for every life area in one call. The dasha and transit scan is shared.
object
date required
string
time required
string
timezoneOffset
Hours from UTC at the given moment, not minutes. Fractional zones are hours too: 5.5 for India, 5.75 for Nepal, -3.5 for Newfoundland. Defaults to 0, meaning UTC. Ignored when timezone is sent.
number
timezone
IANA zone name such as Europe/Kyiv, or auto to look the zone up from latitude and longitude. The server takes the offset that zone kept at this local date and time, summer time included, and uses it in place of timezoneOffset. A clock time that happened twice takes the first occurrence; one skipped when clocks went forward takes the offset from before the change. Abbreviations such as EST are refused. Before 1970 the tz database is not reliable for every place, so send timezoneOffset when the local clock is known.
string
latitude required
number
longitude required
number
houseSystem
string
name
string
city
string
zodiacType
string
ayanamsaId
number
ayanamsa
Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.
string
cosmogram
boolean
fromDate
Start of the span, YYYY-MM-DD (UTC). Today when omitted.
string
years
Length of the span in years, 1 to 20. Default 5.
integer
level
Finest dasha level that cuts the windows. antar (default here, to keep six areas small): maha and antar lords. pratyantar: adds the pratyantar lord, about five times the windows.
string
kp
Add KP significators (Placidus cusps): each dasha lord scores for the houses of the area’s KP group it signifies. Default false.
boolean
minScore
Leave out windows scoring below this. Default 1: every window where at least one rule fired.
number
areas
Areas to return, any of marriage, career, children, property, foreign, education. All when omitted.
Array<string>
Example
{ "date": "1990-05-15", "time": "15:30:00", "timezoneOffset": 3, "latitude": 50.45, "longitude": 30.52, "fromDate": "2026-11-01", "years": 5, "areas": [ "marriage", "career" ]}Responses
Section titled “ Responses ”Successful calculation
Media type application/json
object
ok
boolean
data
object
method
string
window
object
from
string
to
string
years
number
fromJd
number
toJd
number
level
string
natal
object
lagna
object
sign
string
signIndex
number
moonNakshatra
number
ayanamsa
number
houses
string
areas
object
marriage
object
area
string
houses
Array<object>
object
house
number
role
string
meaning
string
basis
string
source
string
sign
string
lord
string
karakas
Array<object>
object
graha
number
meaning
string
basis
string
source
string
name
string
kpHouses
sources
object
dasha-phala
string
drishti
string
node
string
double-transit
string
convergence
string
kp
string
karaka-venus
string
karaka-jupiter
string
windows
Array<object>
object
start
string
end
string
startJd
number
endJd
number
dasha
object
maha
string
antar
string
transitAtStart
object
jupiter
string
saturn
string
score
number
components
object
dasha
number
transit
number
kp
number
convergence
boolean
rules
Array<object>
object
id
string
level
string
planet
string
house
number
points
number
basis
string
source
string
rule
string
summary
object
windows
number
convergenceWindows
number
maxScore
number
best
Array<object>
object
start
string
end
string
score
number
convergence
boolean
career
object
area
string
houses
Array<object>
object
house
number
role
string
meaning
string
basis
string
source
string
sign
string
lord
string
karakas
Array<object>
object
graha
number
meaning
string
basis
string
source
string
name
string
kpHouses
sources
object
dasha-phala
string
drishti
string
node
string
double-transit
string
convergence
string
kp
string
karaka-sun
string
karaka-saturn
string
windows
Array<object>
object
start
string
end
string
startJd
number
endJd
number
dasha
object
maha
string
antar
string
transitAtStart
object
jupiter
string
saturn
string
score
number
components
object
dasha
number
transit
number
kp
number
convergence
boolean
rules
Array<object>
object
id
string
level
string
planet
string
house
number
points
number
basis
string
source
string
rule
string
summary
object
windows
number
convergenceWindows
number
maxScore
number
best
Array<object>
object
start
string
end
string
score
number
convergence
boolean
rulesBasis
object
dasha
string
transit
string
convergence
string
scoring
object
points
object
lord-rules-house
object
primary
number
supporting
number
lord-in-house
object
primary
number
supporting
number
lord-aspects-house
object
primary
number
supporting
number
karaka
object
classical
number
modern
number
node-dispositor
object
primary
number
supporting
number
double-transit-house
number
double-transit-lord
number
kp-significator
number
levelWeight
object
maha
number
antar
number
pratyantar
number
basis
string
note
string
dates
string
Example
{ "ok": true, "data": { "method": "life-area-timing", "window": { "from": "2026-11-01", "to": "2031-11-01", "years": 5, "fromJd": 2461345.5, "toJd": 2463171.75 }, "level": "antar", "natal": { "lagna": { "sign": "Virgo", "signIndex": 5 }, "moonNakshatra": 21, "ayanamsa": 23.722551115821318, "houses": "whole sign from the sidereal Lagna (Parashari); KP uses Placidus cusps" }, "areas": { "marriage": { "area": "marriage", "houses": [ { "house": 7, "role": "primary", "meaning": "spouse, marriage (kalatra bhava)", "basis": "classical", "source": "BPHS ch. 18 (effects of the 7th house), Santhanam numbering", "sign": "Pisces", "lord": "Jupiter" }, { "house": 2, "role": "supporting", "meaning": "family (kutumba), a member added", "basis": "modern", "source": "Parashari convention used with the 7th for marriage; no verse found", "sign": "Libra", "lord": "Venus" }, { "house": 11, "role": "supporting", "meaning": "fulfilment of desires", "basis": "modern", "source": "Parashari convention used with the 7th for marriage; no verse found", "sign": "Cancer", "lord": "Moon" } ], "karakas": [ { "graha": 3, "meaning": "karaka of the spouse (kalatra karaka)", "basis": "classical", "source": "BPHS ch. 32 (Karakas), bhava karaka list, Santhanam numbering", "name": "Venus" }, { "graha": 5, "meaning": "karaka of the husband, applied here to every chart", "basis": "modern", "source": "Later convention for a woman's chart (husband from Jupiter); BPHS names Venus alone for the 7th", "name": "Jupiter" } ], "kpHouses": null, "sources": { "dasha-phala": "BPHS dasha-phala chapters (a dasha gives the results of the houses its lord rules and occupies); Phaladeepika ch. 19 (dasa phala)", "drishti": "BPHS graha drishti: all planets aspect the 7th, Mars also the 4th and 8th, Jupiter the 5th and 9th, Saturn the 3rd and 10th", "node": "Widely taught Parashari convention that Rahu and Ketu give the results of the lord of the sign they occupy; no verse found", "double-transit": "K.N. Rao, double transit of Jupiter and Saturn (Astrology, Destiny and the Wheel of Time; Journal of Astrology). A 20th-century rule, not a classical verse", "convergence": "K.N. Rao: the dasha promises, the double transit times. Convergence here = a maha or antar rule on a primary house or karaka plus a double transit in the same window", "kp": "K.S. Krishnamurti, KP Readers: a planet signifies the houses its star lord occupies and owns, then the houses it occupies and owns (Placidus cusps); house groups per event as taught in KP", "karaka-venus": "BPHS ch. 32 (Karakas), bhava karaka list, Santhanam numbering", "karaka-jupiter": "Later convention for a woman's chart (husband from Jupiter); BPHS names Venus alone for the 7th" }, "windows": [ { "start": "2028-12-26", "end": "2029-03-29", "startJd": 2462131.8400878906, "endJd": 2462224.8767089844, "dasha": { "maha": "Jupiter", "antar": "Jupiter" }, "transitAtStart": { "jupiter": "Libra", "saturn": "Aries" }, "score": 11, "components": { "dasha": 8, "transit": 3, "kp": 0 }, "convergence": true, "rules": [ { "id": "lord-rules-house", "level": "maha", "planet": "Jupiter", "house": 7, "points": 3, "basis": "classical", "source": "dasha-phala", "rule": "Mahadasha lord Jupiter rules the 7th house (Pisces)." }, { "id": "karaka", "level": "maha", "planet": "Jupiter", "points": 1, "basis": "modern", "source": "karaka-jupiter", "rule": "Mahadasha lord Jupiter is the karaka of karaka of the husband, applied here to every chart." }, { "id": "lord-rules-house", "level": "antar", "planet": "Jupiter", "house": 7, "points": 3, "basis": "classical", "source": "dasha-phala", "rule": "Antardasha lord Jupiter rules the 7th house (Pisces)." }, { "id": "karaka", "level": "antar", "planet": "Jupiter", "points": 1, "basis": "modern", "source": "karaka-jupiter", "rule": "Antardasha lord Jupiter is the karaka of karaka of the husband, applied here to every chart." }, { "id": "double-transit-lord", "house": 7, "planet": "Jupiter", "points": 3, "basis": "modern", "source": "double-transit", "rule": "Transit Jupiter in Libra aspects and transit Saturn in Aries aspects natal Jupiter in Gemini, lord of the 7th house." } ] } ], "summary": { "windows": 10, "convergenceWindows": 2, "maxScore": 11, "best": [ { "start": "2028-12-26", "end": "2029-03-29", "score": 11, "convergence": true } ] } }, "career": { "area": "career", "houses": [ { "house": 10, "role": "primary", "meaning": "profession, status (karma bhava)", "basis": "classical", "source": "BPHS ch. 21 (effects of the 10th house), Santhanam numbering", "sign": "Gemini", "lord": "Mercury" }, { "house": 6, "role": "supporting", "meaning": "service, employment", "basis": "modern", "source": "Modern Parashari and KP convention for a job; no verse found", "sign": "Aquarius", "lord": "Saturn" }, { "house": 11, "role": "supporting", "meaning": "gains, income from work", "basis": "modern", "source": "Modern Parashari and KP convention for a job; no verse found", "sign": "Cancer", "lord": "Moon" }, { "house": 2, "role": "supporting", "meaning": "earnings", "basis": "modern", "source": "Modern Parashari and KP convention for a job; no verse found", "sign": "Libra", "lord": "Venus" } ], "karakas": [ { "graha": 0, "meaning": "karaka of the 10th: authority, rank", "basis": "classical", "source": "BPHS ch. 32 (Karakas), bhava karaka list, Santhanam numbering; the list also names Mercury and Jupiter for the 10th, left out here because Jupiter is karaka of five houses and would fire in every area", "name": "Sun" }, { "graha": 6, "meaning": "karaka of the 10th: work, service", "basis": "classical", "source": "BPHS ch. 32 (Karakas), bhava karaka list, Santhanam numbering", "name": "Saturn" } ], "kpHouses": null, "sources": { "dasha-phala": "BPHS dasha-phala chapters (a dasha gives the results of the houses its lord rules and occupies); Phaladeepika ch. 19 (dasa phala)", "drishti": "BPHS graha drishti: all planets aspect the 7th, Mars also the 4th and 8th, Jupiter the 5th and 9th, Saturn the 3rd and 10th", "node": "Widely taught Parashari convention that Rahu and Ketu give the results of the lord of the sign they occupy; no verse found", "double-transit": "K.N. Rao, double transit of Jupiter and Saturn (Astrology, Destiny and the Wheel of Time; Journal of Astrology). A 20th-century rule, not a classical verse", "convergence": "K.N. Rao: the dasha promises, the double transit times. Convergence here = a maha or antar rule on a primary house or karaka plus a double transit in the same window", "kp": "K.S. Krishnamurti, KP Readers: a planet signifies the houses its star lord occupies and owns, then the houses it occupies and owns (Placidus cusps); house groups per event as taught in KP", "karaka-sun": "BPHS ch. 32 (Karakas), bhava karaka list, Santhanam numbering; the list also names Mercury and Jupiter for the 10th, left out here because Jupiter is karaka of five houses and would fire in every area", "karaka-saturn": "BPHS ch. 32 (Karakas), bhava karaka list, Santhanam numbering" }, "windows": [ { "start": "2028-03-16", "end": "2028-07-24", "startJd": 2461847.2998502497, "endJd": 2461976.9216308594, "dasha": { "maha": "Jupiter", "antar": "Jupiter" }, "transitAtStart": { "jupiter": "Leo", "saturn": "Aries" }, "score": 9, "components": { "dasha": 6, "transit": 3, "kp": 0 }, "convergence": true, "rules": [ { "id": "lord-in-house", "level": "maha", "planet": "Jupiter", "house": 10, "points": 3, "basis": "classical", "source": "dasha-phala", "rule": "Mahadasha lord Jupiter occupies the 10th house (Gemini)." }, { "id": "lord-in-house", "level": "antar", "planet": "Jupiter", "house": 10, "points": 3, "basis": "classical", "source": "dasha-phala", "rule": "Antardasha lord Jupiter occupies the 10th house (Gemini)." }, { "id": "double-transit-lord", "house": 10, "planet": "Mercury", "points": 3, "basis": "modern", "source": "double-transit", "rule": "Transit Jupiter in Leo aspects and transit Saturn in Aries occupies natal Mercury in Aries, lord of the 10th house." } ] } ], "summary": { "windows": 12, "convergenceWindows": 3, "maxScore": 13, "best": [ { "start": "2028-12-26", "end": "2029-03-29", "score": 13, "convergence": true } ] } } }, "rulesBasis": { "dasha": "Vimshottari, scored at maha, antar level", "transit": "Jupiter and Saturn by sidereal sign, graha drishti (Jupiter 5, 7, 9; Saturn 3, 7, 10)", "convergence": "K.N. Rao: the dasha promises, the double transit times. Convergence here = a maha or antar rule on a primary house or karaka plus a double transit in the same window", "scoring": { "points": { "lord-rules-house": { "primary": 3, "supporting": 1 }, "lord-in-house": { "primary": 3, "supporting": 1 }, "lord-aspects-house": { "primary": 2, "supporting": 0 }, "karaka": { "classical": 2, "modern": 1 }, "node-dispositor": { "primary": 2, "supporting": 0 }, "double-transit-house": 4, "double-transit-lord": 3, "kp-significator": 1 }, "levelWeight": { "maha": 1, "antar": 1, "pratyantar": 0.5 }, "basis": "scoring", "note": "Points and level weights are this API's, not a text's. They rank windows; the rules that fired are the evidence." }, "dates": "UTC, YYYY-MM-DD; startJd and endJd are exact" } }}Validation error
Media type application/json
Example
{ "ok": false, "error": { "code": "INVALID_INPUT", "message": "Validation failed: date: Date must be YYYY-MM-DD", "details": [ { "path": "date", "message": "Date must be YYYY-MM-DD" } ] }}Missing or invalid API key
Media type application/json
Example
{ "ok": false, "error": { "code": "INVALID_API_KEY", "message": "Invalid API key" }}