Transit Calendar

POST

/transit-calendar

request.sh

curl -X POST https://api.astroway.info/v1/transit-calendar \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "natal": { "date": "1990-05-15", "time": "14:30:00", "timezoneOffset": 3, "latitude": 50.45, "longitude": 30.52 }, "startDate": "2024-01-01", "endDate": "2024-12-31" }'

▸ Спробувати POST /transit-calendar

• Production

Build a month-by-month transit calendar for a natal chart showing exact dates of aspect ingresses and partile hits.

Authorizations

• ApiKeyAuth

Request Body ^required

Media type application/json

Wrapper { natal: ChartInput } used by endpoints that take a base natal plus extra parameters in flat fields.

object

natal required

Birth data for a single natal chart. Required: date (YYYY-MM-DD), time (HH:mm:ss). Defaults to lat/lon/tz=0 if omitted; pass real values for accurate computation.

object

date required

string

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

time required

string

/^\d{2}:\d{2}:\d{2}$/

timezoneOffset

number

0 nullable

latitude

number

0 nullable

longitude

number

0 nullable

houseSystem

string

default: P

name

string

""

city

string

""

zodiacType

string

Allowed values: tropical sidereal

ayanamsaId

number

nullable

cosmogram

boolean

key additional

nullable

startDate required

string

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

endDate required

string

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

maxOrb

number

nullable

aspectAngles

Array<number>

transitPlanetIds

Array<number>

Example

{
  "natal": {
    "date": "1990-05-15",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.45,
    "longitude": 30.52
  },
  "startDate": "2024-01-01",
  "endDate": "2024-12-31"
}

Responses

200

Successful calculation

Media type application/json

object

ok

boolean

data

object

startDate

string

nullable

endDate

string

nullable

maxOrb

number

nullable

count

number

nullable

events

Array<object>

nullable

object

jd

number

nullable

date

string

nullable

transitPlanetId

number

nullable

natalPlanetId

number

nullable

aspect

object

name

string

nullable

angle

number

nullable

symbol

string

nullable

isMajor

boolean

nullable

transitLongitude

number

nullable

natalLongitude

number

nullable

isRetrograde

boolean

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