Life-area timing: all areas

POST

/vedic/timing/all

request.sh

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" ] }'

▸ Спробувати POST /vedic/timing/all

• Production

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

• ApiKeyAuth

Parameters

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

<= 15

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

4

Header Parameters

Idempotency-Key

string

>= 1 characters <= 255 characters /^[\x21-\x7E]+$/

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

01HXY2A7ZM0ABCDEF

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

/^\d{4}-\d{2}-\d{2}$/

time required

string

/^\d{2}:\d{2}(:\d{2})?$/

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

0 nullable >= -14 <= 14

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

>= -90 <= 90

longitude required

number

>= -180 <= 180

houseSystem

string

default: P

Allowed values: P K R C E W B M O A T V D F G H I i L N Q S U X Y

name

string

""

city

string

""

zodiacType

string

Allowed values: tropical sidereal

ayanamsaId

number

nullable

ayanamsa

Sidereal school by name. Lahiri when omitted. Equivalent to ayanamsaId; send either.

string

Allowed values: fagan-bradley lahiri de-luce raman krishnamurti kp yukteshwar jn-bhasin true-citra djwhal-khul

cosmogram

boolean

fromDate

Start of the span, YYYY-MM-DD (UTC). Today when omitted.

string

/^\d{4}-\d{2}-\d{2}$/

years

Length of the span in years, 1 to 20. Default 5.

integer

>= 1 <= 20

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

Allowed values: antar pratyantar

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

nullable <= 100

areas

Areas to return, any of marriage, career, children, property, foreign, education. All when omitted.

Array<string>

>= 1 items <= 6 items

Allowed values: marriage career children property foreign education

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

200

Successful calculation

Media type application/json

object

ok

boolean

data

object

method

string

nullable

window

object

from

string

nullable

to

string

nullable

years

number

nullable

fromJd

number

nullable

toJd

number

nullable

level

string

nullable

natal

object

lagna

object

sign

string

nullable

signIndex

number

nullable

moonNakshatra

number

nullable

ayanamsa

number

nullable

houses

string

nullable

areas

object

marriage

object

area

string

nullable

houses

Array<object>

nullable

object

house

number

nullable

role

string

nullable

meaning

string

nullable

basis

string

nullable

source

string

nullable

sign

string

nullable

lord

string

nullable

karakas

Array<object>

nullable

object

graha

number

nullable

meaning

string

nullable

basis

string

nullable

source

string

nullable

name

string

nullable

kpHouses

nullable

sources

object

dasha-phala

string

nullable

drishti

string

nullable

node

string

nullable

double-transit

string

nullable

convergence

string

nullable

kp

string

nullable

karaka-venus

string

nullable

karaka-jupiter

string

nullable

windows

Array<object>

nullable

object

start

string

nullable

end

string

nullable

startJd

number

nullable

endJd

number

nullable

dasha

object

maha

string

nullable

antar

string

nullable

transitAtStart

object

jupiter

string

nullable

saturn

string

nullable

score

number

nullable

components

object

dasha

number

nullable

transit

number

nullable

kp

number

nullable

convergence

boolean

nullable

rules

Array<object>

nullable

object

id

string

nullable

level

string

nullable

planet

string

nullable

house

number

nullable

points

number

nullable

basis

string

nullable

source

string

nullable

rule

string

nullable

summary

object

windows

number

nullable

convergenceWindows

number

nullable

maxScore

number

nullable

best

Array<object>

nullable

object

start

string

nullable

end

string

nullable

score

number

nullable

convergence

boolean

nullable

career

object

area

string

nullable

houses

Array<object>

nullable

object

house

number

nullable

role

string

nullable

meaning

string

nullable

basis

string

nullable

source

string

nullable

sign

string

nullable

lord

string

nullable

karakas

Array<object>

nullable

object

graha

number

nullable

meaning

string

nullable

basis

string

nullable

source

string

nullable

name

string

nullable

kpHouses

nullable

sources

object

dasha-phala

string

nullable

drishti

string

nullable

node

string

nullable

double-transit

string

nullable

convergence

string

nullable

kp

string

nullable

karaka-sun

string

nullable

karaka-saturn

string

nullable

windows

Array<object>

nullable

object

start

string

nullable

end

string

nullable

startJd

number

nullable

endJd

number

nullable

dasha

object

maha

string

nullable

antar

string

nullable

transitAtStart

object

jupiter

string

nullable

saturn

string

nullable

score

number

nullable

components

object

dasha

number

nullable

transit

number

nullable

kp

number

nullable

convergence

boolean

nullable

rules

Array<object>

nullable

object

id

string

nullable

level

string

nullable

planet

string

nullable

house

number

nullable

points

number

nullable

basis

string

nullable

source

string

nullable

rule

string

nullable

summary

object

windows

number

nullable

convergenceWindows

number

nullable

maxScore

number

nullable

best

Array<object>

nullable

object

start

string

nullable

end

string

nullable

score

number

nullable

convergence

boolean

nullable

rulesBasis

object

dasha

string

nullable

transit

string

nullable

convergence

string

nullable

scoring

object

points

object

lord-rules-house

object

primary

number

nullable

supporting

number

nullable

lord-in-house

object

primary

number

nullable

supporting

number

nullable

lord-aspects-house

object

primary

number

nullable

supporting

number

nullable

karaka

object

classical

number

nullable

modern

number

nullable

node-dispositor

object

primary

number

nullable

supporting

number

nullable

double-transit-house

number

nullable

double-transit-lord

number

nullable

kp-significator

number

nullable

levelWeight

object

maha

number

nullable

antar

number

nullable

pratyantar

number

nullable

basis

string

nullable

note

string

nullable

dates

string

nullable

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"
    }
  }
}

400

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"
      }
    ]
  }
}

401

Missing or invalid API key

Media type application/json

Example

{
  "ok": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Invalid API key"
  }
}