---
title: "Void of Course Moon"
method: GET
path: "/ephemeris/agro/void-of-course"
tags: ["agricultural"]
---

# Void of Course Moon

`GET /ephemeris/agro/void-of-course`

## Request

- Base URL: `https://api.openephemeris.com`
- URL: `https://api.openephemeris.com/ephemeris/agro/void-of-course`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-OpenEphemeris-API-Key`
  - API key in header `X-API-Key`
  - API key in header `X-Service-Key`

Returns the current Void of Course (VoC) Moon window for a given Julian Day.

Method 3: scans backward from the Moon's next sign ingress to find the last
major Ptolemaic aspect (conjunction, sextile, square, trine, opposition) to
a traditional planet. The VoC period runs from that aspect until the ingress.

```bash
GET /ephemeris/agro/void-of-course?jd=2451545.0
```

## Query parameters

- `jd` number, double, required: Julian Day (UT1)

## Headers

- `authorization` string, nullable
- `X-API-Key` string, nullable
- `X-OpenEphemeris-API-Key` string, nullable
- `apikey` string, nullable

## Response `200`

Successful Response

- VoCData
  - `active` boolean, required: True if currently void of course
  - `last_aspect` string: Last major aspect before ingress
  - `last_aspect_jd` number, double: Julian Day of the last major aspect
  - `moon_sign` string, required: Current moon sign
  - `next_sign` string, required: Next moon sign
  - `void_end_jd` number, double, required: Void end Julian Day
  - `void_start_jd` number, double, required: Void start Julian Day

## Other responses

- `400`: Bad Request
- `422`: Validation Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/openephemeris/apis/open-ephemeris-api.md) · [All operations](https://skmtc.dev/openephemeris/apis/open-ephemeris-api/llms.txt) · [OpenAPI document](https://skmtc.dev/openephemeris/apis/open-ephemeris-api/revisions/d195a769cb89?raw)
