Skip to content
96Astro API
Get API Key

Reports

Available

Solar Return Report API

The Western solar return for a year as one report: its moment, rising sign and Midheaven, the year's theme, a reading of each planet and its aspects to the natal chart.

  • POST /v1/reports/report-solar-return
  • 10 credits
Get a free key API reference
Request
curl https://api.96astroapi.com/v1/reports/report-solar-return \  -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 Western solar return for a year as one report: its moment, rising sign and Midheaven, the year's theme, a reading of each planet and its aspects to the natal chart.

Call it with POST /v1/reports/report-solar-return. Input: birth details. Output: JSON, as a direct response (json); pdf via /v1/jobs/pdf; spoken mp3 via /v1/jobs/audio. Each successful call costs 10 credits. As a PDF it costs 130 credits in all.

  • POST /v1/reports/report-solar-return
  • 10 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.

  • titlestring
  • 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 Reports reference.

Related endpoints

FAQ

Solar Return Report API: common questions

4answers

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

The Western solar return for a year as one report: its moment, rising sign and Midheaven, the year's theme, a reading of each planet and its aspects to the natal chart. The response's data object includes title, year, return_moment, ascendant, midheaven, theme, planets and aspects_to_natal. See the reference for an example response.

02What input does Solar Return Report need?

Birth details.

03How much does a Solar Return Report call cost?

10 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.