Solar Return

POST

/solar-return

request.sh

curl -X POST https://api.astroway.info/v1/solar-return \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "date": "1990-05-15", "time": "14:30:00", "timezoneOffset": 3, "latitude": 50.45, "longitude": 30.52, "year": 2024, "locationLat": 50.45, "locationLng": 30.52 }'

▸ Спробувати POST /solar-return

• Production

Find the exact moment when the Sun returns to its natal longitude in a given year. Returns full solar return chart.

Authorizations

• ApiKeyAuth

Request Body ^required

Media type application/json

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

year required

number

nullable

locationLat

number

nullable

locationLng

number

nullable

Example

{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "latitude": 50.45,
  "longitude": 30.52,
  "year": 2024,
  "locationLat": 50.45,
  "locationLng": 30.52
}

Responses

200

Successful calculation

Media type application/json

object

ok

boolean

data

object

returnDate

string

nullable

returnTime

string

nullable

returnJd

number

nullable

chart

object

planets

Array

nullable

houses

object

ascendant

number

nullable

cusps

Array

nullable

aspects

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