---
title: "Get Sky Events"
method: GET
path: "/api/v1/sky-events"
tags: ["Sky Events", "sky-events"]
---

# Get Sky Events

`GET /api/v1/sky-events`

## Request

- Base URL: `https://api.freeastroapi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.freeastroapi.com/api/v1/sky-events`
- Auth: none declared

## Query parameters

- `date` string, required: Local calendar date in YYYY-MM-DD format
- `timezone` string: IANA timezone for local-day boundaries
- `preset` 'quiet' | 'daily' | 'full'
- `include_moon` boolean, nullable: Include Moon sign ingresses
- `include_exact_hits` boolean, nullable: Include exact major planetary aspects
- `include_moon_exact_hits` boolean, nullable: Include exact Moon aspects in exact hits
- `include_ingresses` boolean, nullable: Include non-Moon sign ingresses
- `include_retrogrades` boolean, nullable: Include retrograde and direct stations
- `include_lunations` boolean, nullable: Include New Moon and Full Moon events
- `include_formulation` boolean, nullable: Include a short deterministic event phrase for notifications

## Response `200`

Successful Response

- SkyEventsResponse
  - `date` string, required
  - `timezone` string, required
  - `events` SkyEvent[], required
    - `id` string, required
    - `type` 'moon_ingress' | 'planet_ingress' | 'exact_aspect' | 'retrograde_station' | 'lunation', required
    - `title` string, required
    - `formulation` string, nullable
    - `exact_time` string, required
    - `importance` 'daily' | 'medium' | 'major', required
    - `body` string, nullable
    - `sign` string, nullable
    - `bodies` string[], nullable
    - `aspect` 'conjunction' | 'sextile' | 'square' | 'trine' | 'opposition', nullable
    - `angle` integer, nullable
    - `orb` integer, nullable
    - `direction` 'retrograde' | 'direct', nullable
    - `phase` 'new_moon' | 'full_moon', nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/freeastroapi/apis/astroservice-api.md) · [All operations](https://skmtc.dev/freeastroapi/apis/astroservice-api/llms.txt) · [OpenAPI document](https://skmtc.dev/freeastroapi/apis/astroservice-api/revisions/0c9b4a759522?raw)