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://api.numerologyapi.com/api/v1/horoscope/astrology/returns`
`POST`	`https://api.numerologyapi.com/api/v1/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.

Add the optional lang query parameter to localize responses. Supported values: en, es, de, fr, pt.

Example Requests¶

GET Request¶

curl --request GET \
  --url "https://api.numerologyapi.com/api/v1/horoscope/astrology/returns?returns=solar&lang=en" \
  --header "X-API-Key: YOUR_API_KEY"

POST Request¶

curl --request POST \
  --url "https://api.numerologyapi.com/api/v1/horoscope/astrology/returns?lang=en" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "returns": "solar"
}'

Example Response¶

{
  "return_type": "solar",
  "full_name": "Solar Return",
  "cycle_duration": "≈1 year (exact birthday to next birthday)",
  "symbolic_meaning": "Annual rebirth of the Sun — your personal New Year chart",
  "what_it_activates": "Core identity, life purpose, vitality, conscious direction for the coming year",
  "key_themes": [
    "Overall tone of the year",
    "Where you shine / seek recognition",
    "Major focus areas (look at SR Ascendant + Sun house)"
  ],
  "psychological_focus": "Evolving sense of self, confidence levels, how you want to be seen",
  "spiritual_growth_opportunity": "Aligning ego with soul purpose, stepping into authentic leadership",
  "common_challenges_shadow": [
    "Ego inflation/deflation",
    "Burnout from over-identification with external success",
    "Fear of not being 'enough'"
  ],
  "highest_expression": "Radiant authentic presence, joyful creative contribution",
  "affirmation": "I shine from my true center. This year I live my purpose with courage and joy.",
  "recommended_rituals_practices": [
    "Cast & interpret Solar Return chart near birthday",
    "Sun salutations on birthday",
    "Golden candle ritual for vitality",
    "Vision board for the year ahead"
  ],
  "common_challenges": [
    "Ego inflation/deflation",
    "Burnout from over-identification with external success",
    "Fear of not being 'enough'"
  ],
  "recommended_practices": [],
  "_enterprise": {
    "client": "The Numerology API",
    "plan": "Enterprise",
    "request_id": "90f458dfe1aafa13",
    "quota": "unlimited",
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "The Numerology API by Dakidarts®",
    "api_version": "0.1.1",
    "endpoint_name": "horoscope_astrology_returns",
    "endpoint_description": "Calculates planetary returns (Solar, Lunar, etc.).",
    "developer": "Dakidarts®",
    "copyright": "© 2026 Dakidarts®. All rights reserved.",
    "documentation_url": "https://docs.numerologyapi.com/",
    "response_timestamp": "2026-02-28T07:36:50.607044+01:00",
    "data_source": "Internal Engine / Astro Numerology Interpretation Engine (ANIE)",
    "cacheable_status": true,
    "report_issue": "https://github.com/dakidarts/the-numerology-api/issues",
    "response_language": "en",
    "supported_languages": [
      "en",
      "es",
      "de",
      "fr",
      "pt"
    ],
    "notes": ""
  }
}

Open Dashboard

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