get

/api/v1/positions

Get planetary positions

Overview

Returns positions of all celestial bodies for a given date in tropical zodiac coordinates. When observer location is provided, includes altitude/azimuth for supported bodies.

Parameters

Name	Type	In	Required	Description
`date`	string	query	No	Date in ISO format (YYYY-MM-DD) or datetime (YYYY-MM-DDTHH:MM:SSZ or with offset). Defaults to today.
`timezone`	string	query	No	IANA timezone name (e.g., America/New_York). Used with date-only values to resolve local time.
`bodies`	string	query	No	Comma-separated list of celestial bodies to include
`latitude`	string	query	No	Observer latitude in decimal degrees
`longitude`	string	query	No	Observer longitude in decimal degrees
`elevation`	string	query	No	Observer elevation in meters above sea level Default: `0`

Response

200 — Planetary positions

date string required
positions array required: array of object

object
warnings array: Warnings about calculation accuracy (e.g., Chiron outside ephemeris range); Warnings about calculation accuracy (e.g., Chiron outside ephemeris range)

array of string

Example Request

cURL

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

Example Response

JSON

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