🌐Positions

Celestial body positions API

Positions API can return position for a single body or all available bodies. This is useful if you don't want to make multiple requests for each body, and don't want to get throttled by the API request limitations.

See Body Properties for the available properties of bodies.

Get all bodies positions

GET https://api.astronomyapi.com/api/v2/bodies/positions

Returns an iterable list of bodies and their properties in tabular format.

Query Parameters

NameTypeDescription

latitude*

string

Latitude of the observer's location

longitude*

string

Longitude of the observer's location

elevation*

string

Elevation from the sea in Meters

from_date*

string

Starting date as Date. The maximum number of days you can query is 366 days.

to_date*

string

Ending date as Date. The maximum number of days you can query is 366 days.

time*

string

Observer's time as Time

output

string

Output format.

rows

or

table

. Default is

table

Headers

NameTypeDescription

Authorization*

string

Basic

{
    "data": {
        "dates": {
            "from": "2020-12-20T09:00:00.000-05:00",
            "to": "2020-12-23T09:00:00.000-05:00"
        },
        "observer": {
            "location": {
                "longitude": -84.39733,
                "latitude": 38.775867,
                "elevation": 0
            }
        },
        "table": {
            "header": [
                "2020-12-20T09:00:00.000-05:00",
                "2020-12-21T09:00:00.000-05:00",
                "2020-12-22T09:00:00.000-05:00",
                "2020-12-23T09:00:00.000-05:00"
            ],
            "rows": [
                {
                    "entry": {
                        "id": "sun",
                        "name": "Sun"
                    },
                    "cells": [
                        {
                            "date": "2020-12-20T09:00:00.000-05:00",
                            "id": "sun",
                            "name": "Sun",
                            "distance": {
                                "fromEarth": {
                                    "au": "0.98378",
                                    "km": "147171382.76144"
                                }
                            },
                            "position": {
                                "horizontal": {
                                    "altitude": {
                                        "degrees": "10.04",
                                        "string": "10° 2' 24\""
                                    },
                                    "azimuth": {
                                        "degrees": "131.21",
                                        "string": "131° 12' 36\""
                                    }
                                },
                                "horizonal": {
                                    "altitude": {
                                        "degrees": "10.04",
                                        "string": "10° 2' 24\""
                                    },
                                    "azimuth": {
                                        "degrees": "131.21",
                                        "string": "131° 12' 36\""
                                    }
                                },
                                "equatorial": {
                                    "rightAscension": {
                                        "hours": "17.92",
                                        "string": "17h 55m 12s"
                                    },
                                    "declination": {
                                        "degrees": "-23.43",
                                        "string": "-24° 34' 12\""
                                    }
                                },
                                "constellation": {
                                    "id": "sgr",
                                    "short": "Sgr",
                                    "name": "Sagittarius"
                                }
                            },
                            "extraInfo": {
                                "elongation": 0,
                                "magnitude": -26.77762
                            }
                        },
                        {
                            "date": "2020-12-21T09:00:00.000-05:00",
                            "id": "sun",
                            "name": "Sun",
                            "distance": {
                                "fromEarth": {
                                    "au": "0.98371",
                                    "km": "147160312.87067"
                                }
                            },
                            "position": {
                                "horizontal": {
                                    "altitude": {
                                        "degrees": "9.96",
                                        "string": "9° 57' 36\""
                                    },
                                    "azimuth": {
                                        "degrees": "131.13",
                                        "string": "131° 7' 48\""
                                    }
                                },
                                "horizonal": {
                                    "altitude": {
                                        "degrees": "9.96",
                                        "string": "9° 57' 36\""
                                    },
                                    "azimuth": {
                                        "degrees": "131.13",
                                        "string": "131° 7' 48\""
                                    }
                                },
                                "equatorial": {
                                    "rightAscension": {
                                        "hours": "17.99",
                                        "string": "17h 59m 23s"
                                    },
                                    "declination": {
                                        "degrees": "-23.44",
                                        "string": "-24° 33' 36\""
                                    }
                                },
                                "constellation": {
                                    "id": "sgr",
                                    "short": "Sgr",
                                    "name": "Sagittarius"
                                }
                            },
                            "extraInfo": {
                                "elongation": 0,
                                "magnitude": -26.77778
                            }
                        },
                        {
                            "date": "2020-12-22T09:00:00.000-05:00",
                            "id": "sun",
                            "name": "Sun",
                            "distance": {
                                "fromEarth": {
                                    "au": "0.98364",
                                    "km": "147149972.87077"
                                }
                            },
                            "position": {
                                "horizontal": {
                                    "altitude": {
                                        "degrees": "9.90",
                                        "string": "9° 54' 0\""
                                    },
                                    "azimuth": {
                                        "degrees": "131.03",
                                        "string": "131° 1' 48\""
                                    }
                                },
                                "horizonal": {
                                    "altitude": {
                                        "degrees": "9.90",
                                        "string": "9° 54' 0\""
                                    },
                                    "azimuth": {
                                        "degrees": "131.03",
                                        "string": "131° 1' 48\""
                                    }
                                },
                                "equatorial": {
                                    "rightAscension": {
                                        "hours": "18.07",
                                        "string": "18h 04m 12s"
                                    },
                                    "declination": {
                                        "degrees": "-23.44",
                                        "string": "-24° 33' 36\""
                                    }
                                },
                                "constellation": {
                                    "id": "sgr",
                                    "short": "Sgr",
                                    "name": "Sagittarius"
                                }
                            },
                            "extraInfo": {
                                "elongation": 0,
                                "magnitude": -26.77794
                            }
                        },
                        {
                            "date": "2020-12-23T09:00:00.000-05:00",
                            "id": "sun",
                            "name": "Sun",
                            "distance": {
                                "fromEarth": {
                                    "au": "0.98357",
                                    "km": "147140401.77424"
                                }
                            },
                            "position": {
                                "horizontal": {
                                    "altitude": {
                                        "degrees": "9.83",
                                        "string": "9° 49' 48\""
                                    },
                                    "azimuth": {
                                        "degrees": "130.94",
                                        "string": "130° 56' 24\""
                                    }
                                },
                                "horizonal": {
                                    "altitude": {
                                        "degrees": "9.83",
                                        "string": "9° 49' 48\""
                                    },
                                    "azimuth": {
                                        "degrees": "130.94",
                                        "string": "130° 56' 24\""
                                    }
                                },
                                "equatorial": {
                                    "rightAscension": {
                                        "hours": "18.14",
                                        "string": "18h 08m 24s"
                                    },
                                    "declination": {
                                        "degrees": "-23.42",
                                        "string": "-24° 34' 48\""
                                    }
                                },
                                "constellation": {
                                    "id": "sgr",
                                    "short": "Sgr",
                                    "name": "Sagittarius"
                                }
                            },
                            "extraInfo": {
                                "elongation": 0,
                                "magnitude": -26.77808
                            }
                        }
                    ]
                },
                {
                    "entry": {
                        "id": "moon",
                        "name": "Moon"
                    },
                    "cells": [
                        {
                            "date": "2020-12-20T09:00:00.000-05:00",
                            "id": "moon",
                            "name": "Moon",
                            "distance": {
                                "fromEarth": {
                                    "au": "0.00267",
                                    "km": "398770.33841"
                                }
                            },
                            "position": {
                                "horizontal": {
                                    "altitude": {
                                        "degrees": "-39.40",
                                        "string": "-40° 36' 0\""
                                    },
                                    "azimuth": {
                                        "degrees": "70.99",
                                        "string": "70° 59' 24\""
                                    }
                                },
                                "horizonal": {
                                    "altitude": {
                                        "degrees": "-39.40",
                                        "string": "-40° 36' 0\""
                                    },
                                    "azimuth": {
                                        "degrees": "70.99",
                                        "string": "70° 59' 24\""
                                    }
                                },
                                "equatorial": {
                                    "rightAscension": {
                                        "hours": "23.13",
                                        "string": "23h 07m 48s"
                                    },
                                    "declination": {
                                        "degrees": "-11.96",
                                        "string": "-12° 2' 24\""
                                    }
                                },
                                "constellation": {
                                    "id": "aqr",
                                    "short": "Aqr",
                                    "name": "Aquarius"
                                }
                            },
                            "extraInfo": {
                                "elongation": 74.27557,
                                "magnitude": -9.45722,
                                "phase": {
                                    "angel": "74.2018",
                                    "fraction": "0.042",
                                    "string": "Waxing Crescent"
                                }
                            }
                        },
                        {
                            "date": "2020-12-21T09:00:00.000-05:00",
                            "id": "moon",
                            "name": "Moon",
                            "distance": {
                                "fromEarth": {
                                    "au": "0.00270",
                                    "km": "403433.20005"
                                }
                            },
                            "position": {
                                "horizontal": {
                                    "altitude": {
                                        "degrees": "-43.26",
                                        "string": "-44° 44' 24\""
                                    },
                                    "azimuth": {
                                        "degrees": "56.79",
                                        "string": "56° 47' 24\""
                                    }
                                },
                                "horizonal": {
                                    "altitude": {
                                        "degrees": "-43.26",
                                        "string": "-44° 44' 24\""
                                    },
                                    "azimuth": {
                                        "degrees": "56.79",
                                        "string": "56° 47' 24\""
                                    }
                                },
                                "equatorial": {
                                    "rightAscension": {
                                        "hours": "23.89",
                                        "string": "23h 53m 24s"
                                    },
                                    "declination": {
                                        "degrees": "-7.15",
                                        "string": "-8° 51' 0\""
                                    }
                                },
                                "constellation": {
                                    "id": "aqr",
                                    "short": "Aqr",
                                    "name": "Aquarius"
                                }
                            },
                            "extraInfo": {
                                "elongation": 85.52956,
                                "magnitude": -9.90583,
                                "phase": {
                                    "angel": "85.5048",
                                    "fraction": "0.036",
                                    "string": "Waxing Crescent"
                                }
                            }
                        },
                        {
                            "date": "2020-12-22T09:00:00.000-05:00",
                            "id": "moon",
                            "name": "Moon",
                            "distance": {
                                "fromEarth": {
                                    "au": "0.00272",
                                    "km": "406803.88243"
                                }
                            },
                            "position": {
                                "horizontal": {
                                    "altitude": {
                                        "degrees": "-45.10",
                                        "string": "-46° 54' 0\""
                                    },
                                    "azimuth": {
                                        "degrees": "41.52",
                                        "string": "41° 31' 12\""
                                    }
                                },
                                "horizonal": {
                                    "altitude": {
                                        "degrees": "-45.10",
                                        "string": "-46° 54' 0\""
                                    },
                                    "azimuth": {
                                        "degrees": "41.52",
                                        "string": "41° 31' 12\""
                                    }
                                },
                                "equatorial": {
                                    "rightAscension": {
                                        "hours": "0.61",
                                        "string": "00h 36m 36s"
                                    },
                                    "declination": {
                                        "degrees": "-2.20",
                                        "string": "-3° 48' 0\""
                                    }
                                },
                                "constellation": {
                                    "id": "cet",
                                    "short": "Cet",
                                    "name": "Cetus"
                                }
                            },
                            "extraInfo": {
                                "elongation": 96.54755,
                                "magnitude": -10.29789,
                                "phase": {
                                    "angel": "96.5672",
                                    "fraction": "0.030",
                                    "string": "Waxing Gibbous"
                                }
                            }
                        },
                        {
                            "date": "2020-12-23T09:00:00.000-05:00",
                            "id": "moon",
                            "name": "Moon",
                            "distance": {
                                "fromEarth": {
                                    "au": "0.00273",
                                    "km": "408768.63964"
                                }
                            },
                            "position": {
                                "horizontal": {
                                    "altitude": {
                                        "degrees": "-44.84",
                                        "string": "-45° 9' 36\""
                                    },
                                    "azimuth": {
                                        "degrees": "26.04",
                                        "string": "26° 2' 24\""
                                    }
                                },
                                "horizonal": {
                                    "altitude": {
                                        "degrees": "-44.84",
                                        "string": "-45° 9' 36\""
                                    },
                                    "azimuth": {
                                        "degrees": "26.04",
                                        "string": "26° 2' 24\""
                                    }
                                },
                                "equatorial": {
                                    "rightAscension": {
                                        "hours": "1.32",
                                        "string": "01h 19m 12s"
                                    },
                                    "declination": {
                                        "degrees": "2.74",
                                        "string": "2° 44' 24\""
                                    }
                                },
                                "constellation": {
                                    "id": "psc",
                                    "short": "Psc",
                                    "name": "Pisces"
                                }
                            },
                            "extraInfo": {
                                "elongation": 107.41558,
                                "magnitude": -10.65118,
                                "phase": {
                                    "angel": "107.4676",
                                    "fraction": "0.023",
                                    "string": "Waxing Gibbous"
                                }
                            }
                        }
                    ]
                },
                {
                    "entry": {
                        "id": "mercury",
                        "name": "Mercury"
                    },
                    "cells": [
                        {
                            "date": "2020-12-20T09:00:00.000-05:00",
                            "id": "mercury",
                            "name": "Mercury",
                            "distance": {
                                "fromEarth": {
                                    "au": "1.44663",
                                    "km": "216412357.18070"
                                }
                            },
                            "position": {
                                "horizontal": {
                                    "altitude": {
                                        "degrees": "8.75",
                                        "string": "8° 45' 0\""
                                    },
                                    "azimuth": {
                                        "degrees": "131.99",
                                        "string": "131° 59' 24\""
                                    }
                                },
                                "horizonal": {
                                    "altitude": {
                                        "degrees": "8.75",
                                        "string": "8° 45' 0\""
                                    },
                                    "azimuth": {
                                        "degrees": "131.99",
                                        "string": "131° 59' 24\""
                                    }
                                },
                                "equatorial": {
                                    "rightAscension": {
                                        "hours": "17.93",
                                        "string": "17h 55m 48s"
                                    },
                                    "declination": {
                                        "degrees": "-24.92",
                                        "string": "-25° 4' 48\""
                                    }
                                },
                                "constellation": {
                                    "id": "sgr",
                                    "short": "Sgr",
                                    "name": "Sagittarius"
                                }
                            },
                            "extraInfo": {
                                "elongation": 1.50745,
                                "magnitude": -1.31155
                            }
                        },
                        {
                            "date": "2020-12-21T09:00:00.000-05:00",
                            "id": "mercury",
                            "name": "Mercury",
                            "distance": {
                                "fromEarth": {
                                    "au": "1.44477",
                                    "km": "216134837.46619"
                                }
                            },
                            "position": {
                                "horizontal": {
                                    "altitude": {
                                        "degrees": "8.26",
                                        "string": "8° 15' 36\""
                                    },
                                    "azimuth": {
                                        "degrees": "131.50",
                                        "string": "131° 30' 0\""
                                    }
                                },
                                "horizonal": {
                                    "altitude": {
                                        "degrees": "8.26",
                                        "string": "8° 15' 36\""
                                    },
                                    "azimuth": {
                                        "degrees": "131.50",
                                        "string": "131° 30' 0\""
                                    }
                                },
                                "equatorial": {
                                    "rightAscension": {
                                        "hours": "18.05",
                                        "string": "18h 03m 00s"
                                    },
                                    "declination": {
                                        "degrees": "-25.00",
                                        "string": "-25° 0' 0\""
                                    }
                                },
                                "constellation": {
                                    "id": "sgr",
                                    "short": "Sgr",
                                    "name": "Sagittarius"
                                }
                            },
                            "extraInfo": {
                                "elongation": 1.76363,
                                "magnitude": -1.29482
                            }
                        },
                        {
                            "date": "2020-12-22T09:00:00.000-05:00",
                            "id": "mercury",
                            "name": "Mercury",
                            "distance": {
                                "fromEarth": {
                                    "au": "1.44234",
                                    "km": "215771107.43777"
                                }
                            },
                            "position": {
                                "horizontal": {
                                    "altitude": {
                                        "degrees": "7.78",
                                        "string": "7° 46' 48\""
                                    },
                                    "azimuth": {
                                        "degrees": "131.00",
                                        "string": "131° 0' 0\""
                                    }
                                },
                                "horizonal": {
                                    "altitude": {
                                        "degrees": "7.78",
                                        "string": "7° 46' 48\""
                                    },
                                    "azimuth": {
                                        "degrees": "131.00",
                                        "string": "131° 0' 0\""
                                    }
                                },
                                "equatorial": {
                                    "rightAscension": {
                                        "hours": "18.17",
                                        "string": "18h 10m 12s"
                                    },
                                    "declination": {
                                        "degrees": "-25.06",
                                        "string": "-26° 56' 24\""
                                    }
                                },
                                "constellation": {
                                    "id": "sgr",
                                    "short": "Sgr",
                                    "name": "Sagittarius"
                                }
                            },
                            "extraInfo": {
                                "elongation": 2.14413,
                                "magnitude": -1.26822
                            }
                        },
                        {
                            "date": "2020-12-23T09:00:00.000-05:00",
                            "id": "mercury",
                            "name": "Mercury",
                            "distance": {
                                "fromEarth": {
                                    "au": "1.43933",
                                    "km": "215320384.16055"
                                }
                            },
                            "position": {
                                "horizontal": {
                                    "altitude": {
                                        "degrees": "7.30",
                                        "string": "7° 18' 0\""
                                    },
                                    "azimuth": {
                                        "degrees": "130.49",
                                        "string": "130° 29' 24\""
                                    }
                                },
                                "horizonal": {
                                    "altitude": {
                                        "degrees": "7.30",
                                        "string": "7° 18' 0\""
                                    },
                                    "azimuth": {
                                        "degrees": "130.49",
                                        "string": "130° 29' 24\""
                                    }
                                },
                                "equatorial": {
                                    "rightAscension": {
                                        "hours": "18.29",
                                        "string": "18h 17m 24s"
                                    },
                                    "declination": {
                                        "degrees": "-25.09",
                                        "string": "-26° 54' 36\""
                                    }
                                },
                                "constellation": {
                                    "id": "sgr",
                                    "short": "Sgr",
                                    "name": "Sagittarius"
                                }
                            },
                            "extraInfo": {
                                "elongation": 2.59661,
                                "magnitude": -1.23712
                            }
                        }
                    ]
                },
                {
                    "entry": {
                        "id": "venus",
                        "name": "Venus"
                    },
                    "cells": [
                        {
                            "date": "2020-12-20T09:00:00.000-05:00",
                            "id": "venus",
                            "name": "Venus",
                            "distance": {
                                "fromEarth": {
                                    "au": "1.51668",
                                    "km": "226892479.91564"
                                }
                            },
                            "position": {
                                "horizontal": {
                                    "altitude": {
                                        "degrees": "24.97",
                                        "string": "24° 58' 12\""
                                    },
                                    "azimuth": {
                                        "degrees": "149.65",
                                        "string": "149° 39' 0\""
                                    }
                                },
                                "horizonal": {
                                    "altitude": {
                                        "degrees": "24.97",
                                        "string": "24° 58' 12\""
                                    },
                                    "azimuth": {
                                        "degrees": "149.65",
                                        "string": "149° 39' 0\""
                                    }
                                },
                                "equatorial": {
                                    "rightAscension": {
                                        "hours": "16.28",
                                        "string": "16h 16m 48s"
                                    },
                                    "declination": {
                                        "degrees": "-20.19",
                                        "string": "-21° 48' 36\""
                                    }
                                },
                                "constellation": {
                                    "id": "sco",
                                    "short": "Sco",
                                    "name": "Scorpius"
                                }
                            },
                            "extraInfo": {
                                "elongation": 23.0487,
                                "magnitude": -3.87581
                            }
                        },
                        {
                            "date": "2020-12-21T09:00:00.000-05:00",
                            "id": "venus",
                            "name": "Venus",
                            "distance": {
                                "fromEarth": {
                                    "au": "1.52066",
                                    "km": "227487606.29970"
                                }
                            },
                            "position": {
                                "horizontal": {
                                    "altitude": {
                                        "degrees": "24.62",
                                        "string": "24° 37' 12\""
                                    },
                                    "azimuth": {
                                        "degrees": "149.46",
                                        "string": "149° 27' 36\""
                                    }
                                },
                                "horizonal": {
                                    "altitude": {
                                        "degrees": "24.62",
                                        "string": "24° 37' 12\""
                                    },
                                    "azimuth": {
                                        "degrees": "149.46",
                                        "string": "149° 27' 36\""
                                    }
                                },
                                "equatorial": {
                                    "rightAscension": {
                                        "hours": "16.36",
                                        "string": "16h 21m 36s"
                                    },
                                    "declination": {
                                        "degrees": "-20.44",
                                        "string": "-21° 33' 36\""
                                    }
                                },
                                "constellation": {
                                    "id": "sco",
                                    "short": "Sco",
                                    "name": "Scorpius"
                                }
                            },
                            "extraInfo": {
                                "elongation": 22.81549,
                                "magnitude": -3.8748
                            }
                        },
                        {
                            "date": "2020-12-22T09:00:00.000-05:00",
                            "id": "venus",
                            "name": "Venus",
                            "distance": {
                                "fromEarth": {
                                    "au": "1.52460",
                                    "km": "228077053.65050"
                                }
                            },
                            "position": {
                                "horizontal": {
                                    "altitude": {
                                        "degrees": "24.28",
                                        "string": "24° 16' 48\""
                                    },
                                    "azimuth": {
                                        "degrees": "149.26",
                                        "string": "149° 15' 36\""
                                    }
                                },
                                "horizonal": {
                                    "altitude": {
                                        "degrees": "24.28",
                                        "string": "24° 16' 48\""
                                    },
                                    "azimuth": {
                                        "degrees": "149.26",
                                        "string": "149° 15' 36\""
                                    }
                                },
                                "equatorial": {
                                    "rightAscension": {
                                        "hours": "16.45",
                                        "string": "16h 27m 00s"
                                    },
                                    "declination": {
                                        "degrees": "-20.68",
                                        "string": "-21° 19' 12\""
                                    }
                                },
                                "constellation": {
                                    "id": "oph",
                                    "short": "Oph",
                                    "name": "Ophiuchus"
                                }
                            },
                            "extraInfo": {
                                "elongation": 22.58214,
                                "magnitude": -3.87383
                            }
                        },
                        {
                            "date": "2020-12-23T09:00:00.000-05:00",
                            "id": "venus",
                            "name": "Venus",
                            "distance": {
                                "fromEarth": {
                                    "au": "1.52850",
                                    "km": "228660857.21992"
                                }
                            },
                            "position": {
                                "horizontal": {
                                    "altitude": {
                                        "degrees": "23.94",
                                        "string": "23° 56' 24\""
                                    },
                                    "azimuth": {
                                        "degrees": "149.06",
                                        "string": "149° 3' 36\""
                                    }
                                },
                                "horizonal": {
                                    "altitude": {
                                        "degrees": "23.94",
                                        "string": "23° 56' 24\""
                                    },
                                    "azimuth": {
                                        "degrees": "149.06",
                                        "string": "149° 3' 36\""
                                    }
                                },
                                "equatorial": {
                                    "rightAscension": {
                                        "hours": "16.54",
                                        "string": "16h 32m 24s"
                                    },
                                    "declination": {
                                        "degrees": "-20.91",
                                        "string": "-21° 5' 24\""
                                    }
                                },
                                "constellation": {
                                    "id": "oph",
                                    "short": "Oph",
                                    "name": "Ophiuchus"
                                }
                            },
                            "extraInfo": {
                                "elongation": 22.34865,
                                "magnitude": -3.87289
                            }
                        }
                    ]
                },
                {
                    "entry": {
                        "id": "earth",
                        "name": "Earth"
                    },
                    "cells": [
                        {
                            "date": "2020-12-20T09:00:00.000-05:00",
                            "id": "earth",
                            "name": "Earth",
                            "distance": {
                                "fromEarth": {
                                    "au": "0.00004",
                                    "km": "6369.79183"
                                }
                            },
                            "position": {
                                "horizontal": {
                                    "altitude": {
                                        "degrees": "-89.81",
                                        "string": "-90° 11' 24\""
                                    },
                                    "azimuth": {
                                        "degrees": "360.00",
                                        "string": "360° 0' 0\""
                                    }
                                },
                                "horizonal": {
                                    "altitude": {
                                        "degrees": "-89.81",
                                        "string": "-90° 11' 24\""
                                    },
                                    "azimuth": {
                                        "degrees": "360.00",
                                        "string": "360° 0' 0\""
                                    }
                                },
                                "equatorial": {
                                    "rightAscension": {
                                        "hours": "2.33",
                                        "string": "02h 19m 48s"
                                    },
                                    "declination": {
                                        "degrees": "-38.68",
                                        "string": "-39° 19' 12\""
                                    }
                                },
                                "constellation": {
                                    "id": "for",
                                    "short": "For",
                                    "name": "Fornax"
                                }
                            },
                            "extraInfo": {