get

/api/v1/positions/today

Get today's planetary positions

Overview

Shorthand endpoint for current planetary positions. When observer location is provided, includes altitude/azimuth for supported bodies.

Parameters

NameTypeInRequiredDescription
bodiesstringqueryNo

Comma-separated list of celestial bodies to include

latitudestringqueryNo

Observer latitude in decimal degrees

longitudestringqueryNo

Observer longitude in decimal degrees

elevationstringqueryNo

Observer elevation in meters above sea level

Default: 0

Response

200 — Today's planetary positions

date string required
positions array required

array of object

object

Example Request

cURL
curl "https://api.almuten.io/api/v1/positions/today" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

JSON
{
  "date": "2025-11-26",
  "positions": [
    {}
  ]
}