logo

Planetary Returns API

Solar Return is the most popular and is covered completely by our SR calculations and interpretations API.

We also offer planetary returns API for Saturn, Node, Jupiter among others.

solar-return

Solar return

Get Solar return on your website and app with ease. Know how upcoming year looks like with Solar return API.

image

Solar return interpretations

Integrate the Solar return detailed and accurate interpreations for your business. The API also calculates active yearly theme to be focused for the entire year.

image

3. More planetary returns

More Planetary returns like Jupiter, Saturn help creating wide range of report. The detailed interpreations and accurate calculation enhances the feature of websites and apps.

image

Solar return charts for the year ahead

A solar return is the moment each year when the Sun goes back to the exact place it held at birth. It falls on or near the birthday. Astrologers cast a chart for that moment and read it as a guide to the coming year.

Our Solar Return API finds that moment for any year and builds the chart for you. Send the birth details plus solar_year, the year you want. We return the return date, planets, houses, aspects and readable forecasts.

Use the data for birthday features, yearly reports or a forecast screen that refreshes every year.

  • Return date and time

    The exact solar return date and time for the year you ask for.

  • Return chart planets

    Each planet and the ascendant in the return chart, with sign, degree, house and retrograde flag.

  • Return house cusps

    All 12 house cusps of the return chart, plus the ascendant, midheaven and vertex.

  • Return chart aspects

    Angles between planets in the return chart, each with its type and orb.

  • Planet forecasts

    For each planet, its sign in the return chart and four paragraphs on what the year may bring.

  • Aspect forecasts

    Readings for links between return chart planets and birth chart planets, such as Uranus opposite natal Neptune.

Solar return endpoints, with real responses

Each call is a POST with day, month, year, hour, min, lat, lon and tzone. Add solar_year for the return you want. Samples are trimmed from our docs.

Base URL: https://json.astrologyapi.com/v1

POST/solar_return_details

Return date

The birth date, plus the solar return date and time for solar_year. Show it as a countdown to the user’s new solar year.

1{
2  "native_birth_date": "05-15-2011 12:10:00",
3  "native_age": null,
4  "solar_return_date": "05-15-2018 05:09:35"
5}
Read the /solar_return_details reference →
POST/solar_return_planets

Return chart planets

The planets and ascendant of the return chart. Each one has sign, degree, speed, house and isRetro.

1[
2  { "name": "Sun", "sign": "Taurus", "house": 1, "isRetro": "false" },
3  { "name": "Moon", "sign": "Taurus", "house": 1, "isRetro": "false" },
4  { "name": "Ascendant", "sign": "Taurus", "house": 1, "isRetro": false }
5]
Read the /solar_return_planets reference →
POST/solar_return_planet_aspects

Return chart aspects

Aspects inside the return chart. Each one names the two planets, the aspect type and the orb.

1[
2  {
3    "solar_return_planet": "Sun",
4    "aspecting_planet": "Moon",
5    "type": "Conjunction",
6    "orb": 6.8
7  },
8  {
9    "solar_return_planet": "Sun",
10    "aspecting_planet": "Mars",
11    "type": "Trine",
12    "orb": 5.4
13  }
14]
Read the /solar_return_planet_aspects reference →
POST/solar_return_planet_report

Planet forecasts

Readable forecasts for each planet in the return chart. The full response gives each planet four paragraphs.

1[
2  {
3    "name": "Mars",
4    "isRetro": "false",
5    "sign": "Cancer",
6    "forecast": [
7      "It is more about how you express yourself than the specifics of what you are saying that helps sway others to your position. "
8    ]
9  }
10]
Read the /solar_return_planet_report reference →

Who builds with solar returns

More than 3,000+ businesses use AstrologyAPI. A birthday is a natural moment to offer a yearly reading.

Birthday features

Send each user a yearly forecast on their solar return date. Start from their natal chart.

Natal Chart API →

Report sellers

Sell a branded solar return report as a PDF each year.

Western PDF Report API →

Forecast apps

Pair the yearly return chart with monthly transits for a fuller view of the year.

Transit API →

Vedic yearly charts

Varshaphal is the Vedic version of a yearly chart. We offer it as a PDF report.

Varshaphal PDF reference →

Solar Return API FAQ

What is a solar return chart?

It is a chart cast for the moment each year when the Sun goes back to its birth position. Astrologers read it for the themes of the year that follows.

What do I send in a request?

Send the usual birth fields: day, month, year, hour, min, lat, lon and tzone. Add solar_year to choose the year of the return, such as 2025.

Does the return always fall on the birthday?

Not always. The Sun can come back on the day before or after the birthday. solar_return_details gives you the exact date and time, so you never have to work it out.

Do you cover other planetary returns?

The endpoints in our docs cover the solar return. If you need another return, such as Saturn or Jupiter, contact us about a custom API.

Which languages are supported?

solar_return_planets, solar_return_house_cusps and solar_return_planet_aspects support English, Spanish, Portuguese, French, Italian, German and Russian. The two forecast reports are in English.

Is there a PDF version?

Yes. solar_return_report/tropical builds a solar return PDF with your logo and company details. It is part of our Western PDF reports.

Are you ready to bring Astrology to your website & app?

Think no more. We've got you covered with affordable pricing, simple documentation and round the clock support