get

/api/v1/planetary-hours/next/{ruler}

Get the next hour ruled by a specific planet

Overview

Returns when the next planetary hour ruled by the specified planet will occur.

Parameters

Name	Type	In	Required	Description
`ruler`	string	path	Yes	Planet to find next hour for Allowed: `SaturnJupiterMarsSunVenusMercuryMoon`
`latitude`	string	query	Yes	Observer latitude in degrees (-90 to 90)
`longitude`	string	query	Yes	Observer longitude in degrees (-180 to 180)

Response

200 — Next hour ruled by the planet

hourNumber number required
isDayHour boolean required
ruler string required: Enum:
SaturnJupiterMarsSunVenusMercuryMoon
start string required
startTimestamp string required
end string required
endTimestamp string required
durationMinutes number required

Example Request

cURL

curl "https://api.almuten.io/api/v1/planetary-hours/next/{ruler}" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

JSON

{
  "hourNumber": 0,
  "isDayHour": true,
  "ruler": "Saturn",
  "start": "",
  "startTimestamp": "",
  "end": "",
  "endTimestamp": "",
  "durationMinutes": 0
}