GET /v1/ingresses — Find when a planet crosses into a zodiac sign or reaches a specific ecliptic longitude.

Sign Ingresses

Find when a planet crosses a specific ecliptic longitude — typically a zodiac sign boundary. Useful for tracking seasonal boundaries (equinoxes, solstices), zodiac ingresses, and planetary cycles.

Text

GET  /v1/ingresses
POST /v1/ingresses

Credit cost: 2

Parameters

Parameter	Type	Required	Default	Description
`datetime`	string	One of `datetime` or `jd`	—	ISO 8601 UTC datetime
`jd`	number	One of `datetime` or `jd`	—	Julian Day in UT1
`body`	string	Yes	—	Body name (sun, moon, or planet)
`sign`	string	One of `sign` or `longitude`	—	Zodiac sign name (e.g., `aries`)
`longitude`	number	One of `sign` or `longitude`	—	Target ecliptic longitude (0–360)
`backward`	boolean	No	`false`	Search backward in time
`count`	integer	No	1	Number of results (1–10)

Body restrictions: Nodes, apogees, and asteroids are not supported in v1. Supported bodies: sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto.

Coordinate system note: Sun and Moon ingresses use geocentric longitude. Other planets use heliocentric longitude (as returned by the Swiss Ephemeris longitude crossing algorithm).

Response

JSON

{
  "data": [
    {
      "body": "sun",
      "target_longitude": 0.0,
      "sign": "aries",
      "sign_degree": 0.0,
      "jd": 2460389.308,
      "datetime": "2024-03-20T03:24:00.000Z"
    }
  ],
  "meta": { "..." }
}

Field	Type	Description
`body`	string	Body identifier
`target_longitude`	number	The target ecliptic longitude
`sign`	string	Zodiac sign at target longitude
`sign_degree`	number	Degree within the sign
`jd`	number	Julian Day of the crossing (UT1)
`datetime`	string	ISO 8601 datetime of the crossing

Examples

Vernal equinox (Sun into Aries)

Bash

curl "https://api.morphemeris.com/v1/ingresses?datetime=2024-01-01T00:00:00Z&body=sun&sign=aries" \
  -H "Authorization: Bearer morphemeris_live_YOUR_KEY"

javascript

const res = await fetch(
  "https://api.morphemeris.com/v1/ingresses?datetime=2024-01-01T00:00:00Z&body=sun&sign=aries",
  { headers: { Authorization: "Bearer morphemeris_live_YOUR_KEY" } }
);
const data = await res.json();

Python

import requests

res = requests.get(
    "https://api.morphemeris.com/v1/ingresses",
    params={"datetime": "2024-01-01T00:00:00Z", "body": "sun", "sign": "aries"},
    headers={"Authorization": "Bearer morphemeris_live_YOUR_KEY"},
)
data = res.json()

Next 5 vernal equinoxes

Bash

curl "https://api.morphemeris.com/v1/ingresses?datetime=2024-01-01T00:00:00Z&body=sun&sign=aries&count=5" \
  -H "Authorization: Bearer morphemeris_live_YOUR_KEY"

Summer solstice (Sun at 90 degrees)

Bash

curl "https://api.morphemeris.com/v1/ingresses?datetime=2024-01-01T00:00:00Z&body=sun&longitude=90" \
  -H "Authorization: Bearer morphemeris_live_YOUR_KEY"

Sign Ingresses

Sign Ingresses

Parameters

Response

Examples

Vernal equinox (Sun into Aries)

Next 5 vernal equinoxes

Summer solstice (Sun at 90 degrees)

On this page