Sky ingresses¶

Free · all plans

`GET /v1/vedic/sky/ingresses`¶

Scope: charts:read. When each planet crosses into its next sign between two moments — no birth chart involved. The same planet enters a sign on different dates in the two zodiacs, so the answer names the one it was read in.

Query	Type	Required	Notes
`starts_at`	ISO 8601 datetime with offset	yes
`ends_at`	ISO 8601 datetime with offset	yes	after `starts_at`, at most 400 days later
`system`	`vedic` \| `western`	no (`vedic`)	Vedic = sidereal (Lahiri); Western = tropical

curl "https://api.astrolinkers.com/v1/vedic/sky/ingresses?starts_at=2026-11-01T00:00:00Z&ends_at=2027-01-01T00:00:00Z&system=vedic" \
  -H "Authorization: Bearer $ASTROLINKERS_API_KEY"

{
  "system": "vedic",
  "starts_at": "2026-11-01T00:00:00Z",
  "ends_at": "2027-01-01T00:00:00Z",
  "method_version": "sky-ingresses-v2",
  "events": [
    {"planet": "venus", "event_type": "direct_ingress", "moment": "2026-11-21T04:00:00Z",
     "longitude": 210.0, "from_sign": "virgo", "to_sign": "libra"}
  ]
}

events[] is sorted by moment. Each moment is the first whole hour (UTC) after the crossing — accurate to the hour, so grouping by the reader's local date is safe. (sky-ingresses-v1 dated crossings to the next UTC midnight, a day late for readers at UTC or west of it.) Planets: sun, mercury, venus, mars, jupiter, saturn, rahu, ketu (the Moon is left out — it changes sign every ~2.3 days). event_type is direct_ingress or retrograde_ingress.

Status	`error.code`	When
`422`	`invalid_date_range`	A bound without timezone, `ends_at` before `starts_at`, or more than 400 days.
`422`	`invalid_request`	Unknown `system` or an unreadable datetime.

Sky ingresses¶

GET /v1/vedic/sky/ingresses¶

`GET /v1/vedic/sky/ingresses`¶