---
title: "Get Moon Phases & Void-of-Course Windows"
slug: get-phases
url: https://apyhub.com/creightonnick0/service/get-phases
provider: nick creighton
categories: [Geolocation, Standard Data]
tags: [moon-phases, astronomy, lunar-calendar, time-zones]
auth: api_key
---

# Get Moon Phases & Void-of-Course Windows

Get New, First Quarter, Full, and Last Quarter moon dates for a range in UTC, with optional local time zone output for calendar apps.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| GET | `/v1/lunar/phases` | What it does Returns the next 12 upcoming Moon phases from today (UTC). No parameters needed. Query… | 10 |
| GET | `/v1/lunar/voc` | What it does Returns the next upcoming void-of-course Moon window(s) starting from now. No paramete… | 10 |

## About

## What it does
Moon Phases & Void-of-Course gives you the upcoming lunar schedule in one call — no input required. It returns the next 12 upcoming Moon phases (new, first quarter, full, last quarter) **and** the next upcoming void-of-course windows, starting from right now.

The response includes two top-level sections: `phases` (with its own `count`) and `voc_windows` (with its own `count`). Each phase item gives you `phase` and `exact_utc`. Each void-of-course window gives you `start_utc`, `end_utc`, `leaving_sign`, and `entering_sign` — marking exactly when the Moon makes its last aspect before going void, and when it ingresses into the next sign to end the void period.

Use this endpoint when you need lunar-timing awareness for scheduling, publishing, or ritual-planning logic — for example, showing the upcoming phase calendar while also flagging void periods to avoid for launches, signings, or important decisions. Because both datasets are forward-looking from "now" with zero setup, it's a drop-in feed for dashboards, astrology apps, and calendar integrations that need the full near-term lunar picture without stitching together two separate calls.

## Usage

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