---
title: "Lunar Today"
method: GET
path: "/api/lunar/today"
tags: ["lunar"]
---

# Lunar Today

`GET /api/lunar/today`

## Request

- Base URL: `https://api.stellara.natlex.it` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stellara.natlex.it/api/lunar/today`
- Auth: none declared

Get the current moon phase, right now, in UTC.

We intentionally use `datetime.now(UTC)` instead of `date.today()`
so the phase tracks the real illumination fraction at the moment
of the request. `date.today()` on Cloud Run is UTC midnight of the
server's wall clock — for a Moscow user checking at 01:00 local
(22:00 UTC the previous day), that meant they saw the previous UTC
day's phase even though astronomically the moon had already moved
forward by ~13° of apparent longitude.

## Response `200`

Successful Response

- LunarDayResponse
  - `date` string, required
  - `phase_name_en` string, nullable
  - `phase_name_ru` string, nullable
  - `phase_key` string, nullable
  - `illumination` number, nullable
  - `emoji` string, nullable

---

[API](https://skmtc.dev/natlex/apis/stellara-api.md) · [All operations](https://skmtc.dev/natlex/apis/stellara-api/llms.txt) · [OpenAPI document](https://skmtc.dev/natlex/apis/stellara-api/revisions/e576f046b61f?raw)