Retornos Astrológicos¶

O endpoint Retornos Astrológicos explica o conceito de retornos planetários, destacando como cada retorno representa um novo ciclo na vida de uma pessoa. Os retornos podem fornecer insights sobre crescimento pessoal, oportunidades e eventos importantes na vida, dependendo do planeta envolvido.

Perfeito para entusiastas da astrologia, intérpretes de gráficos e qualquer pessoa que busca entender o momento dos ciclos de vida em seu mapa natal.

Endpoint¶

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

Parâmetros de Consulta¶

Nome	Obrigatório	Tipo	Exemplo	Descrição
`returns`	✅	String	`solar`	Nome do retorno astrológico. Valores suportados: `solar`, `lunar`, `mercury`, `venus`, `mars`, `jupiter`, `saturn`.

Nota

Parâmetros ausentes ou inválidos resultarão em um erro 400. Ambos os métodos GET e POST são suportados.

Adicione o parâmetro de consulta opcional lang para localizar as respostas. Valores suportados: en, es, de, fr, pt.

Exemplos de Solicitações¶

Solicitação 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"

Solicitação 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"
}'

Resposta de Exemplo¶

{
  "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 Painel

Nota

Campos de Resposta:

returns — Nome do retorno astrológico
definition — Explicação geral dos retornos planetários e sua relevância na vida
returns_summary — Descrição detalhada do retorno planetário selecionado