POST/v1/western/solar-return

Western Solar Return

Solar return chart for a given year. Finds the exact moment the Sun returns to its natal tropical longitude and builds a complete Western natal chart for that moment at the birth location. Provide the year as an integer (e.g. 2026).

Request parameters

locationoptional

string | null

City name to resolve to lat/lon/tz automatically. Example: 'Mumbai' or 'New Delhi, India'. If provided, latitude, longitude and timezone are not required.

nameoptional

string

Person name associated with the birth record

daterequired

string

Birth date in YYYY-MM-DD format

timeoptional

string | null

Birth time in HH:MM 24-hour format. If omitted, sunrise chart is used as fallback.

latitudeoptional

number | null

Latitude. Required if location not provided.

longitudeoptional

number | null

Longitude. Required if location not provided.

timezoneoptional

string | null

IANA timezone. Required if location not provided.

ayanamsaoptional

string

Sidereal ayanamsa mode used in calculations

yearrequired

integer

Year for the solar return (e.g. 2026)

Response fields

success

boolean

True if the request succeeded

message

string

Human-readable status message

data

object

data.planet

string

data.natal_longitude

number

Natal longitude of the return planet (tropical)

data.return_utc

string

Exact UTC moment of return (ISO 8601)

data.return_jd

number

Julian Day of return moment

data.chart

object

data.chart.zodiac

string

Always 'tropical' for Western natal

data.chart.house_system

string

House system used

data.chart.ascendant

object

data.chart.ascendant.longitude

number

Tropical ecliptic longitude 0–360°

data.chart.ascendant.sign

string

Zodiac sign name

data.chart.ascendant.sign_index

integer

Sign index 0=Aries … 11=Pisces

data.chart.ascendant.degree_in_sign

number

Degrees within sign 0–29.999

data.chart.mc

object

data.chart.mc.longitude

number

Tropical ecliptic longitude 0–360°

data.chart.mc.sign

string

Zodiac sign name

data.chart.mc.sign_index

integer

Sign index 0=Aries … 11=Pisces

data.chart.mc.degree_in_sign

number

Degrees within sign 0–29.999

data.chart.planets

array[object]

data.chart.planets[].name

string

Planet name

data.chart.planets[].longitude

number

Tropical ecliptic longitude 0–360°

data.chart.planets[].sign

string

Zodiac sign name

data.chart.planets[].sign_index

integer

data.chart.planets[].degree_in_sign

number

Degrees within sign 0–29.999

data.chart.planets[].house

integer

House number (Placidus or chosen system)

data.chart.planets[].is_retrograde

boolean

data.chart.planets[].dignity

string

Essential dignity: domicile | exaltation | detriment | fall | peregrine

data.chart.planets[].dignity_score

integer

Essential dignity weight: domicile=5, exaltation=4, detriment=-5, fall=-4, peregrine=0

data.chart.planets[].is_exaltation_degree

boolean

True if planet is in the exact classical exaltation degree (Nth degree = N-1°00' to N-1°59'59"). Always false for outer planets (no exact degree defined).

data.chart.planets[].dignity_disputed

boolean

True for outer planet (Uranus/Neptune/Pluto) exaltation/fall — no classical consensus.

data.chart.houses

array[object]

data.chart.houses[].house

integer

data.chart.houses[].cusp_longitude

number

Tropical ecliptic longitude of house cusp

data.chart.houses[].sign

string

data.chart.houses[].sign_index

integer

data.chart.houses[].degree_in_sign

number

data.chart.aspects

array[object]

data.chart.aspects[].planet_a

string

data.chart.aspects[].planet_b

string

data.chart.aspects[].type

string

Aspect type: conjunction | opposition | trine | square | sextile | semisextile | semisquare | sesquiquadrate | quincunx

data.chart.aspects[].exact_angle

number

Actual angular distance between planets

data.chart.aspects[].orb

number

Difference from exact aspect angle (always positive)

data.chart.aspects[].is_applying

boolean

True if the faster planet is moving toward exact aspect (orb decreasing).

data.chart.elements

object

data.chart.elements.fire

integer

data.chart.elements.earth

integer

data.chart.elements.air

integer

data.chart.elements.water

integer

data.chart.elements.dominant

string | null

Most common element, or null if tied

data.chart.modalities

object

data.chart.modalities.cardinal

integer

data.chart.modalities.fixed

integer

data.chart.modalities.mutable

integer

data.chart.modalities.dominant

string | null

data.chart.hemisphere

object

data.chart.hemisphere.eastern

integer

Planet count in houses 7–12

data.chart.hemisphere.western

integer

Planet count in houses 1–6

data.chart.hemisphere.northern

integer

Planet count in houses 1–6 (below horizon)

data.chart.hemisphere.southern

integer

Planet count in houses 7–12 (above horizon)

data.chart.ayanamsa_value

number

Always 0.0 — tropical zodiac

data.chart.ayanamsa_used

string

data.chart.birth_time_provided

boolean

Whether a precise birth time was provided. False when birth time was not supplied or treated as unknown — calculations using this field will have lagna-dependent accuracy limits.

Errors

authentication_failed

Missing or invalid API key.

ephemeris_unavailable

Upstream ephemeris service error.

insufficient_tier

API key tier does not include this endpoint.

internal_error

Unexpected server error.

ip_rate_limit_exceeded

Too many requests in a short window.

payload_too_large

Request body exceeds the size limit.

resource_not_found

Referenced resource was not found.

validation_error

Request body failed schema validation.

Related endpoints

• Western Lunar Return
• Western Planetary Return

Request

POST·application/json

curl

curl -X POST "https://api.asterwise.com/v1/western/solar-return" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Arjun Mehta","date":"1985-11-12","time":"06:45","latitude":19.076,"longitude":72.8777,"timezone":"Asia/Kolkata","year":2026}'

Python

import asterwise
from asterwise.api.western_astrology_api import WesternAstrologyApi
from asterwise.models.solar_return_request import SolarReturnRequest

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

request = SolarReturnRequest(
    name="Arjun Mehta",
    date="1985-11-12",
    time="06:45",
    latitude=19.076,
    longitude=72.8777,
    timezone="Asia/Kolkata",
    year=2026,
)

with asterwise.ApiClient(configuration) as client:
    api = WesternAstrologyApi(client)
    result = api.western_solar_return(solar_return_request=request)
    print(result)

TypeScript

import { createClient, createConfig, westernSolarReturn } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await westernSolarReturn({
  client,
  body: {
      "name": "Arjun Mehta",
      "date": "1985-11-12",
      "time": "06:45",
      "latitude": 19.076,
      "longitude": 72.8777,
      "timezone": "Asia/Kolkata",
      "year": 2026
  },
});

console.log(result.data);

Response

200 OK·application/jsonsigned

{
  "success": true,
  "message": "success",
  "data": {
    "planet": "Sun",
    "natal_longitude": 229.596712,
    "return_utc": "2026-11-11T23:39:35Z",
    "return_jd": 2461356.485833,
    "chart": {
      "zodiac": "tropical",
      "house_system": "placidus",
      "ascendant": {
        "longitude": 207.191024,
        "sign": "Libra",
        "sign_index": 6,
        "degree_in_sign": 27.191024
      },
      "mc": {
        "longitude": 116.862747,
        "sign": "Cancer",
        "sign_index": 3,
        "degree_in_sign": 26.862747
      },
      "planets": [
        {
          "name": "Sun",
          "longitude": 229.596701,
          "sign": "Scorpio",
          "sign_index": 7,
          "degree_in_sign": 19.596701,
          "house": 1,
          "is_retrograde": false,
          "dignity": "peregrine",
          "dignity_score": 0,
          "is_exaltation_degree": false,
          "dignity_disputed": false
        },
        {
          "name": "Moon",
          "longitude": 259.675103,
          "sign": "Sagittarius",
          "sign_index": 8,
          "degree_in_sign": 19.675103,
          "house": 2,
          "is_retrograde": false,
          "dignity": "peregrine",
          "dignity_score": 0,
          "is_exaltation_degree": false,
          "dignity_disputed": false
        },
        "... and 8 more items"
      ],
      "houses": [
        {
          "house": 1,
          "cusp_longitude": 207.191024,
          "sign": "Libra",
          "sign_index": 6,
          "degree_in_sign": 27.191024
        },
        {
          "house": 2,
          "cusp_longitude": 236.548299,
          "sign": "Scorpio",
          "sign_index": 7,
          "degree_in_sign": 26.548299
        },
        "... and 10 more items"
      ],
      "aspects": [
        {
          "planet_a": "Jupiter",
          "planet_b": "Mars",
          "type": "conjunction",
          "exact_angle": 1.5683,
          "orb": 1.5683,
          "is_applying": true
        },
        {
          "planet_a": "Jupiter",
          "planet_b": "Venus",
          "type": "sextile",
          "exact_angle": 57.4363,
          "orb": 2.5637,
          "is_applying": false
        },
        "... and 12 more items"
      ],
      "elements": {
        "fire": 5,
        "earth": 0,
        "air": 3,
        "water": 2,
        "dominant": "fire"
      },
      "modalities": {
        "cardinal": 3,
        "fixed": 5,
        "mutable": 2,
        "dominant": "fixed"
      },
      "hemisphere": {
        "eastern": 4,
        "western": 6,
        "northern": 6,
        "southern": 4
      },
      "ayanamsa_value": 0.0,
      "ayanamsa_used": "tropical",
      "birth_time_provided": true
    }
  }
}