---
title: Get Lunar Calendar API
slug: get-calendar-year
url: https://apyhub.com/creightonnick0/service/get-calendar-year
provider: nick creighton
categories: [Standard Data]
tags: [calendar, astrology, events, timeline, year-view]
auth: api_key
---

# Get Lunar Calendar API

Get a year-level calendar for phases, sign ingresses, sabbats, and planetary events from a single year input.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| GET | `/v1/lunar/calendar/:year` | What it does Returns a full calendar-year payload for the requested year, timezone, and hemisphere,… | 10 |

## About

## What it does
Calendar Year Events gives you a render-ready calendar of moon phases, moon sign ingresses, sabbats, and planetary events for a given year.

Send a year, and you get back a structured response with `year`, `hemisphere`, `tz`, `verified`, `moon_phases`, `moon_signs`, `planetary_events`, and `sabbats`. You can request a timezone with `tz` and choose `hemisphere` as `north` or `south`; sabbat dates are returned with both local dates and exact UTC timestamps, while moon phases and planetary events are timestamped in UTC.

Use it when you need astrology or seasonal event data for a website calendar, planning dashboard, editorial schedule, or a ceremonial event page. The `verified` field helps you surface that the year has been astronomically checked, and the response is designed to be rendered directly without extra transformation.

If you are building a calendar view, this service gives you the event list you need in one response instead of stitching together phases, sign changes, and seasonal markers from separate sources.

## Usage

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