Skip to content

Astrology Returns

The Astrology Returns endpoint explains the concept of planetary returns, highlighting how each return represents a new cycle in a person’s life.
Returns can provide insight into personal growth, opportunities, and key life events, depending on the planet involved.

Perfect for astrology enthusiasts, chart interpreters, and anyone seeking to understand the timing of life cycles in their natal chart.

Endpoint

Method Path
GET https://the-numerology-api.p.rapidapi.com/horoscope/astrology/returns
POST https://the-numerology-api.p.rapidapi.com/horoscope/astrology/returns

Query Parameters

Name Required Type Example Description
returns ✅ String solar Name of the astrology return. Supported values: solar, lunar, mercury, venus, mars, jupiter, saturn.

Note

Missing or invalid parameters will return a 400 error.
Both GET and POST methods are supported.

Example Requests

GET Request

curl -X GET "https://the-numerology-api.p.rapidapi.com/horoscope/astrology/returns?returns=solar" \
  -H "x-rapidapi-key: YOUR_RAPIDAPI_KEY"

POST Request

curl -X POST "https://the-numerology-api.p.rapidapi.com/horoscope/astrology/returns" \
  -H "Content-Type: application/json" \
  -H "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
  -d '{
        "returns": "solar"
      }'

Example Response

{
  "definition": "A return signifies the moment a planet travels through the zodiac and “returns” to the exact same sign and degree it was the day a person was born. Overall, returns represent a new cycle in someone’s life—the start of a new phase and the opportunities for personal growth and change. Some returns are yearly (such as the sun, Mercury, and Venus), some are monthly (like the moon), and others only happen every few years. It makes total sense then, that the longer a planet takes to go through the zodiac, the more impactful its return will be on your life. It will also indicate how long those effects will last. Because returns represent a new cycle in a person’s life, it has a great effect on that person’s birth chart...",
  "returns": "Solar Returns",
  "returns_summary": "A solar return occurs once every 365 days, usually on a person’s birthday—but not always (especially if you were born on a cusp). The sun's return can recharge your life’s purpose and suggest the kind of events that lie ahead for the next year of your life."
}

View on RapidAPI

Note

Response Fields:

  • returns — Name of the astrology return
  • definition — General explanation of planetary returns and life significance
  • returns_summary — Detailed description of the selected planetary return