get

/api/v1/fixed-stars/{name}

Get a single fixed star by name

Overview

Returns the position of a specific fixed star (case-insensitive name matching). Optionally includes rise/set/culmination times when observer location is provided.

Parameters

Name	Type	In	Required	Description
`name`	string	path	Yes	Star name (case-insensitive)
`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.
`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 — Star position

date string required

star object required

name string required
constellation string required
longitude number required
sign string required
degree number required
minute number required
magnitude number required
nature string required
keywords array required: array of string
rise string
set string
culmination string
isPermanentlyAboveHorizon boolean
isPermanentlyBelowHorizon boolean

Example Request

cURL

curl "https://api.almuten.io/api/v1/fixed-stars/{name}" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

JSON

{
  "date": "",
  "star": {
    "name": "",
    "constellation": "",
    "longitude": 0,
    "sign": "",
    "degree": 0,
    "minute": 0,
    "magnitude": 0,
    "nature": "",
    "keywords": [
      ""
    ],
    "rise": "",
    "set": "",
    "culmination": "",
    "isPermanentlyAboveHorizon": true,
    "isPermanentlyBelowHorizon": true
  }
}