🌐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
Headers
{
"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": {
"elongation": null,
"magnitude": null
}
},
{
"date": "2020-12-21T09:00:00.000-05:00",
"id": "earth",
"name": "Earth",
"distance": {