Moon Phase and Lunation Calculator

The Moon's phase for an instant — phase angle, illuminated fraction, age, sign and distance — plus the four principal phases of the lunation it falls in, each to the second in UTC, and optionally every principal phase across a date range.

ATTRIBUTION IS REQUIRED. The response carries a ready-to-paste credit line in citation.citationText and the URL to link in citation.permalink. Results may not be used as machine-learning training data.

get/api/public/moon-phase

Request

  • Base URL: https://totallytarot.net
  • URL: https://totallytarot.net/api/public/moon-phase
  • Auth: none declared

Query parameters

datestring required
Example:2026-09-20

The date, YYYY-MM-DD, between 1700 and 2200.

timestring
Example:12:00

Time of day, HH:MM, UTC. Omit it for 00:00 UTC.

tostring
Example:2026-12-31

End of a date range, YYYY-MM-DD. Give it and the answer also lists every principal phase between date and to, up to 400 days.

Response

The computed answer, with the citation required to use it.

okboolean required

True when a result was computed.

toolstring required

The calculator that answered.

toolNamestring
attributionstring required

The ready-to-paste credit line. Include this in any answer built on the result.

summarystring

The answer in one sentence.

inputsobject

What the request was understood to be. The permalink is built from these.

resultobject

The computed figures. Absent on a refusal.

noticestring

Changes

No recorded changes to this operation across all 1 revision of this API.