---
title: "Western horary chart facts"
method: POST
path: "/v1/western/horary"
tags: ["Western Astrology"]
---

# Western horary chart facts

`POST /v1/western/horary`

## Request

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

The chart of a question's moment with the facts Lilly's horary method reads, each rule named. House rulers (traditional rulers), the significators (lord of the 1st and the Moon for the querent, lord of the quesited house), their aspects with Lilly's orbs and whether an applying aspect perfects before a sign change, the Moon's last and next aspects and void-of-course state, combustion, and the considerations before judgement (radicality by the hour lord, early or late Ascendant, Saturn in the 7th, the Moon in the Via Combusta). The yes or no is left to the reader. Christian Astrology (1647).

## Request body

- WesternHoraryRequest
  - `date` string, required: Date the question was asked, YYYY-MM-DD (local).
  - `time` string, required: Time the question was asked, HH:MM (24-hour, local).
  - `location` string, nullable: Place the question was asked, as a city name.
  - `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 of the place.
  - `house_system` 'placidus' | 'koch' | 'equal' | 'whole_sign': Lilly used Regiomontanus, which is not yet available; Placidus is the default.
  - `quesited_house` integer, nullable: The house of the matter asked about (7 for a partner, 10 for a job, 2 for money …). Its ruler becomes the quesited's significator.

## Response `200`

Successful Response

- ApiResponseWesternHoraryResponse
  - `success` boolean: True if the request succeeded
  - `message` string: Human-readable status message
  - `data` WesternHoraryResponse, required
    - `moment_utc` string, required
    - `moment_local` string, required
    - `house_system` string, required
    - `sect` string, required
    - `ascendant` object, required
    - `mc` object, required
    - `planets` object[], required: Each planet: sign, degree, house, retrograde, speed, dignity and Lilly's essential dignities, combustion.
    - `house_rulers` object[], required: Traditional ruler of each house cusp and where that ruler stands.
    - `quesited_house` integer, nullable, required
    - `significators` object[], required: Lord of the 1st and the Moon for the querent; lord of the quesited house when given.
    - `aspects_between_significators` object[], required: Aspect, orb against the moiety of Lilly's orbs, applying or separating, exact time, and whether it perfects before a sign change.
    - `moon` object, required: Separating-from and applying-to aspects within the Moon's sign, void of course, Via Combusta, late degrees.
    - `considerations` object, required: Lilly's considerations before judgement, each as a flag with its rule.
    - `orbs` object, required
    - `note` string, 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)
