---
title: Get Planetary Hours API
slug: get-planetary-hours
url: https://apyhub.com/creightonnick0/service/get-planetary-hours
provider: nick creighton
categories: [Geolocation, Standard Data]
tags: [astrology, planetary-hours, sunrise-sunset, solar-time, location-aware]
auth: api_key
---

# Get Planetary Hours API

Get 24 planetary hours for a latitude, longitude, and date, with sunrise and sunset. Useful for astrology and solar-time scheduling.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| GET | `/v1/lunar/planetary-hours` | What it does Returns the 24 unequal planetary hours for a given latitude, longitude, and date, alon… | 10 |

## About

## What it does
Planetary Hours gives you the 24 unequal Chaldean hours for a specific latitude, longitude, and date. Send a date plus `lat` and `lng`, and you get the local day ruler, sunrise and sunset in UTC, and a full hour-by-hour schedule.

Each hour item includes its `index`, `period` (`day` or `night`), ruling planet in Chaldean order, and `start_utc` / `end_utc` timestamps. The response also echoes back the input `date`, `lat`, and `lng`, so you can store or audit the calculation without keeping the original request separately.

Use Planetary Hours when you need location-aware timing for astrology tools, ritual planners, or any application that depends on sunrise/sunset-based day partitions. Because the hours are unequal, the schedule is derived from the actual daylight and nighttime length at the requested coordinates rather than a fixed 60-minute clock.

It is a good fit for apps that need a deterministic planetary timetable for a given place and date, with enough detail to render a calendar, timeline, or hourly planner from the API response.

## Usage

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/creightonnick0/service/get-planetary-hours