get

/api/v1/ingress/{body}

Get ingresses for a specific body

Overview

Returns when a specific planet enters new zodiac signs within the date range.

Parameters

Name	Type	In	Required	Description
`body`	string	path	Yes	Celestial body name Allowed: `SunMoonMercuryVenusMarsJupiterSaturnUranusNeptunePlutoChironNorthNodeSouthNodeNorthNodeMeanSouthNodeMeanCeresJunoVestaPallasLilithMeanLilithTrueErisSednaMakemakeHaumeaQuaoarIxionVarunaHygieaAstraeaPsycheErosSapphoAmorCupidoHadesZeusKronosApollonAdmetosVulkanusPoseidonVertexAntiVertex`
`startDate`	string	query	Yes	Start date in ISO format (YYYY-MM-DD)
`endDate`	string	query	Yes	End date in ISO format (YYYY-MM-DD)
`timezone`	string	query	No	IANA timezone name (e.g., America/New_York). Used with date-only values to resolve local time.

Response

200 — List of ingress events for the body

body string required

startDate string required

endDate string required

count number required

ingresses array required

array of object

body string required
sign string required: Enum:
AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces
signBoundary number required
date string required
timestamp string required
isRetrograde boolean required
direction string required: Enum:
directretrograde

Example Request

cURL

curl "https://api.almuten.io/api/v1/ingress/{body}" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

JSON

{
  "body": "",
  "startDate": "",
  "endDate": "",
  "count": 0,
  "ingresses": [
    {
      "body": "",
      "sign": "Aries",
      "signBoundary": 0,
      "date": "",
      "timestamp": "",
      "isRetrograde": true,
      "direction": "direct"
    }
  ]
}