Retornos Astrológicos¶

El endpoint Retornos Astrológicos explica el concepto de retornos planetarios, destacando cómo cada retorno representa un nuevo ciclo en la vida de una persona. Los retornos pueden proporcionar información sobre crecimiento personal, oportunidades y eventos clave en la vida, dependiendo del planeta involucrado.

Perfecto para entusiastas de la astrología, intérpretes de cartas y cualquier persona que busque comprender el momento de los ciclos de vida en su carta natal.

Endpoint¶

Método	Ruta
`GET`	`https://api.numerologyapi.com/api/v1/horoscope/astrology/returns`
`POST`	`https://api.numerologyapi.com/api/v1/horoscope/astrology/returns`

Parámetros de Consulta¶

Nombre	Requerido	Tipo	Ejemplo	Descripción
`returns`	✅	String	`solar`	Nombre del retorno astrológico. Valores admitidos: `solar`, `lunar`, `mercury`, `venus`, `mars`, `jupiter`, `saturn`.

Nota

Los parámetros faltantes o inválidos devolverán un error 400. Se admiten los métodos GET y POST.

Agregue el parámetro de consulta opcional lang para localizar las respuestas. Valores admitidos: en, es, de, fr, pt.

Ejemplos de Solicitudes¶

Solicitud GET¶

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

Solicitud POST¶

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"
}'

Ejemplo de Respuesta¶

{
  "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": ""
  }
}

Abrir Panel de Control

Nota

Campos de Respuesta:

returns — Nombre del retorno astrológico
definition — Explicación general de los retornos planetarios y su significado en la vida
returns_summary — Descripción detallada del retorno planetario seleccionado