Moon Phase

POST

/moon-phase

request.sh

curl -X POST https://api.astroway.info/v1/moon-phase \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "date": "2024-01-25", "time": "12:00:00", "latitude": 0, "longitude": 0, "timezoneOffset": 0 }'

▸ Спробувати POST /moon-phase

• Production

Current moon phase at a given moment — illumination %, age in days, elongation, waxing/waning, sun + moon zodiac signs. Geocentric Sun-Moon elongation per Meeus Ch.48.

Authorizations

• ApiKeyAuth

Request Body ^required

Media type application/json

object

Example

{
  "date": "2024-01-25",
  "time": "12:00:00",
  "latitude": 0,
  "longitude": 0,
  "timezoneOffset": 0
}

Responses

200

Successful calculation

Media type application/json

object

ok

boolean

data

object

phase

number

nullable

phaseName

string

nullable

majorPhase

string

nullable

illuminationPercent

number

nullable

elongationDeg

number

nullable

ageDays

number

nullable

waxing

boolean

nullable

moonSign

string

nullable

sunSign

string

nullable

moonLongitude

number

nullable

sunLongitude

number

nullable

Example

{
  "ok": true,
  "data": {
    "phase": 0.999,
    "phaseName": "Full Moon",
    "majorPhase": "full_moon",
    "illuminationPercent": 99.94,
    "elongationDeg": 177.25,
    "ageDays": 14.54,
    "waxing": true,
    "moonSign": "Leo",
    "sunSign": "Aquarius",
    "moonLongitude": 122.24,
    "sunLongitude": 304.99
  }
}

400

Validation error

Media type application/json

Example

{
  "ok": false,
  "error": {
    "code": "INVALID_INPUT",
    "message": "Validation failed: date: Date must be YYYY-MM-DD",
    "details": [
      {
        "path": "date",
        "message": "Date must be YYYY-MM-DD"
      }
    ]
  }
}

401

Missing or invalid API key

Media type application/json

Example

{
  "ok": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Invalid API key"
  }
}