Yearly Forecast

POST

/bazi/yearly

request.sh

curl -X POST https://api.astroway.info/v1/bazi/yearly \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "natalDate": "1990-05-15", "targetYear": 2027 }'

▸ Спробувати POST /bazi/yearly

• Production

Compares target year pillar against natal day master + natal year branch. Returns element-flow relation (companion / mother / output / control / wealth) per Sheng-Ke cycle, branch clashes (六冲), and trine support (三合).

Authorizations

• ApiKeyAuth

Request Body ^required

Media type application/json

object

Example

{
  "natalDate": "1990-05-15",
  "targetYear": 2027
}

Responses

200

Successful calculation

Media type application/json

object

ok

boolean

data

object

natalDayMaster

object

element

string

nullable

yin

boolean

nullable

targetPillar

object

pillar

string

nullable

animal

string

nullable

elementFlow

object

stem

object

element

string

nullable

relation

string

nullable

flavor

string

nullable

branch

object

branchInteractions

object

clashes

Array

nullable

trineSupport

Array

nullable

Example

{
  "ok": true
}

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