get

/api/v1/moon/voc/periods

Get VOC periods within a date range

Overview

Returns all void-of-course Moon periods within the specified date range. Each period includes when it starts (last aspect), when it ends (sign change), duration, and which aspect was last made.

Parameters

Name	Type	In	Required	Description
`startDate`	string	query	Yes	Start date in ISO format (YYYY-MM-DD)
`endDate`	string	query	Yes	End date in ISO format (YYYY-MM-DD)
`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`

Response

200 — List of VOC periods

startDate string required

endDate string required

planetSet string required

Enum:

traditionalmodern

count number required

periods array required

array of object

start string required

startTimestamp string required

end string required

endTimestamp string required

durationMinutes number required

moonSign string required

Enum:

AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces

nextSign string required

Enum:

AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces

lastAspect object required

planet string required
type string required

Example Request

cURL

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

Example Response

JSON

{
  "startDate": "",
  "endDate": "",
  "planetSet": "traditional",
  "count": 0,
  "periods": [
    {
      "start": "",
      "startTimestamp": "",
      "end": "",
      "endTimestamp": "",
      "durationMinutes": 0,
      "moonSign": "Aries",
      "nextSign": "Aries",
      "lastAspect": {
        "planet": "",
        "type": ""
      }
    }
  ]
}