Skip to content
96Astro API
Get API Key

Western astrology

Available

Solar Return Readings API

The year's theme, a forecast for each planet in the return chart, and its aspects to the natal chart.

  • POST /v1/western/western-solar-return-report
  • 3 credits
Get a free key API reference
Request
curl https://api.96astroapi.com/v1/western/western-solar-return-report \  -H "Authorization: Bearer $ASTRO_API_KEY" \  -H "Content-Type: application/json" \  -d '{
      "datetime": "1990-10-18T14:30:00",
      "timezone": "Asia/Kolkata",
      "latitude": 28.6139,
      "longitude": 77.209,
      "target_year": 2026
    }'

Overview

The year's theme, a forecast for each planet in the return chart, and its aspects to the natal chart.

Call it with POST /v1/western/western-solar-return-report. Input: birth details. Output: JSON, as a direct response. Each successful call costs 3 credits.

  • POST /v1/western/western-solar-return-report
  • 3 credits
  • Birth details

Try it

Runs the real calculation, free and without a key, a few times a minute. For more, and for AI readings, get a free sandbox key.

Response

Ready when you are

Press Run it to see the live response here.

Example response

Fields in dataMeasured from 3 real answers to different inputs: a required field was in every one.

  • yearnumber
  • return_momentstring
  • ascendantobject
  • midheavenobject
  • themestring
  • planetsarray of object
  • aspects_to_natalarray of object
200Example response

Captured from the live engine with a sandbox key (so credits_used is 0) and trimmed: long arrays keep their first items and images are replaced by a placeholder.

Loading the example…

Request schema and every field: the Western astrology reference.

Related endpoints

FAQ

Solar Return Readings API: common questions

4answers

Ask the team
01What does the Solar Return Readings API return?

The year's theme, a forecast for each planet in the return chart, and its aspects to the natal chart. The response's data object includes year, return_moment, ascendant, midheaven, theme, planets and aspects_to_natal. See the reference for an example response.

02What input does Solar Return Readings need?

Birth details.

03How much does a Solar Return Readings call cost?

3 credits per successful call; a failed call is not charged. Plans and top-ups are on the pricing page.

04Can I try it before paying?

Yes. Every account gets sandbox keys and trial credits, so you can call it from your own code before choosing a plan.