---
title: "Western day view (GET)"
method: GET
path: "/v1/western/day"
tags: ["Western Astrology"]
---

# Western day view (GET)

`GET /v1/western/day`

## Request

- Base URL: `https://api.asterwise.com`
- URL: `https://api.asterwise.com/v1/western/day`
- Auth: HTTP bearer

Same answer as the POST route with the same fields as query parameters; cacheable (public, 10 minutes).

## Query parameters

- `date` string, required: Date, YYYY-MM-DD (local civil date at the place).
- `location` string, nullable: City name, used when latitude/longitude/timezone are not given.
- `latitude` number, nullable: Latitude in decimal degrees, north positive. Use with longitude and timezone instead of location.
- `longitude` number, nullable: Longitude in decimal degrees, east positive. Use with latitude and timezone instead of location.
- `timezone` string, nullable: IANA timezone, e.g. Europe/London.

## Response `200`

Successful Response

- ApiResponseWesternDayResponse
  - `success` boolean: True if the request succeeded
  - `message` string: Human-readable status message
  - `data` WesternDayResponse, required
    - `date` string, required
    - `timezone` string, required
    - `start` string, required: Local midnight that opens the day, ISO 8601 with offset.
    - `end` string, required: Local midnight that closes it.
    - `start_utc` string, required
    - `end_utc` string, required
    - `status` 'ok' | 'no_sunrise': no_sunrise at polar latitudes: planetary_hours is then null.
    - `status_detail` string, nullable
    - `planetary_hours` PlanetaryHour[], nullable: Every planetary hour that overlaps the civil day (the hours after midnight come from the previous sunrise's night).
      - `hour` integer, required: 1–12 are day hours (sunrise to sunset), 13–24 night hours.
      - `period` 'day' | 'night', required
      - `planet` string, required: Planet ruling this hour.
      - `start_local` string, required: Start, local time with UTC offset (ISO 8601).
      - `end_local` string, required: End, local time with UTC offset (ISO 8601).
      - `start_utc` string, required: Start in UTC (ISO 8601 with Z).
      - `end_utc` string, required: End in UTC (ISO 8601 with Z).
      - `length_minutes` number, required
      - `is_current` boolean, required: True if the current moment falls in this hour.
    - `void_of_course` WesternDayVoidPeriod[], required: Void-of-course Moon periods that overlap the civil day (traditional rule, see /v1/western/moon/void-of-course).
      - `start_utc` string, required
      - `end_utc` string, required
      - `duration_hours` number, required
      - `moon_sign` string, required
      - `next_sign` string, required
      - `last_aspect` VoidOfCourseLastAspect
        - `planet` string, required: Planet of the Moon's last exact aspect in the sign.
        - `aspect` string, required: Aspect type: conjunction, sextile, square, trine or opposition.
        - `exact_at` string, required: UTC moment that aspect was exact (ISO 8601 with Z).
      - `whole_sign_void` boolean, required
    - `moon` WesternDayMoon, required
      - `sign_at_start` string, required: Tropical Moon sign at local midnight opening the day.
      - `sign_at_end` string, required: Tropical Moon sign at the midnight closing it.
      - `sign_changes` MoonSignChange[], required: Moon sign changes inside the day, with exact times.
        - `at_utc` string, required
        - `at_local` string, required
        - `from_sign` string, required
        - `to_sign` string, required
      - `phase_name` string, required: Moon phase for the date (eight 45° phases).
      - `illumination_pct` number, required
      - `is_waxing` boolean, required

## Other responses

- `401`: Authentication failed
- `403`: Authorization failed
- `404`: Resource not found
- `413`: Payload too large
- `422`: Validation error
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream provider error
- `503`: Service unavailable

---

[API](https://skmtc.dev/asterwise/apis/asterwise-api.md) · [All operations](https://skmtc.dev/asterwise/apis/asterwise-api/llms.txt) · [OpenAPI document](https://skmtc.dev/asterwise/apis/asterwise-api/revisions/3c4bbb1194e2?raw)