get

/api/v1/moon/voc

Get current Void-of-Course Moon status

Overview

Check if the Moon is currently void-of-course. The Moon is void-of-course when it has made its last major aspect (conjunction, sextile, square, trine, opposition) before leaving its current sign. **Planet Sets:** - `traditional`: Sun, Mercury, Venus, Mars, Jupiter, Saturn - `modern`: Adds Uranus, Neptune, Pluto (more restrictive, shorter VOC periods)

Parameters

Name Type In Required Description

Name	Type	In	Required	Description
`date`	string	query	No	Date in ISO format (YYYY-MM-DD) or datetime (YYYY-MM-DDTHH:MM:SSZ or with offset). Defaults to today.
`timezone`	string	query	No	IANA timezone name (e.g., America/New_York). Used with date-only values to resolve local time.
`planets`	string	query	No	Planet set for VOC calculation. Traditional: Sun through Saturn. Modern: includes Uranus, Neptune, Pluto. Allowed: `traditionalmodern` Default: `modern`

date

string

query

Date in ISO format (YYYY-MM-DD) or datetime (YYYY-MM-DDTHH:MM:SSZ or with offset). Defaults to today.

timezone

string

query

IANA timezone name (e.g., America/New_York). Used with date-only values to resolve local time.

planets

string

query

Planet set for VOC calculation. Traditional: Sun through Saturn. Modern: includes Uranus, Neptune, Pluto.

Allowed:

traditionalmodern

Default: modern

Response

200 — VOC status

isVoc boolean required
moonSign string required: Enum:
AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces
moonLongitude number required
vocStarted string
vocEnds string
nextVoc string
remainingMinutes number

Example Request

cURL

curl "https://api.almuten.io/api/v1/moon/voc" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

JSON

{
  "isVoc": true,
  "moonSign": "Aries",
  "moonLongitude": 0,
  "vocStarted": "",
  "vocEnds": "",
  "nextVoc": "",
  "remainingMinutes": 0
}