JPL Solar System Dynamics
App · 20 actions
NASA JPL's data on asteroids, comets and the solar system: close approaches to Earth, fireballs, impact risks, the Small-Body Database, newly discovered objects, human-accessible asteroids, mission targets, radar data, Julian dates, and where any planet, moon, spacecraft or asteroid is from Horizons. No account or API key required.
Actions
| Action | What it does |
|---|---|
| Convert date to Julian day | Turn a date and time (UTC) into its Julian day number, the count of days astronomers use, and its Modified Julian Date. |
| Convert Julian day to date | Turn a Julian day number into its calendar date and time (UTC), day of the week and day of the year. |
| Find asteroids and comets in a sky area | List the known asteroids and comets inside a square patch of sky at a given time, as seen from an observatory or a place on Earth: their positions, brightness and motion. |
| Get asteroid or comet | Look up one asteroid or comet in JPL's Small-Body Database by name, number or designation: its orbit, orbit class, whether it is a near-Earth or potentially hazardous object, size, rotation, composition, discovery, moons and any possible Earth impacts. |
| Get human-accessible asteroid | Get the round trips NHATS found to one near-Earth asteroid: the cheapest and the shortest, each with its launch date, legs, stay and fuel needs. |
| Get impact risk | Get Sentry's impact assessment for one asteroid: every date it could hit Earth with the odds, hazard ratings and impact energy, plus its size and observation history. |
| Get newly discovered object | Get Scout's latest assessment of one newly discovered object by its temporary name. |
| Get position in space | Get where a body is in space, as X, Y and Z position and velocity relative to the Sun, Earth or another center, at a moment or over a span of time, with its distance and light time. |
| Get sky position | Find where the Sun, a planet, a moon, a spacecraft, an asteroid or a comet appears in the sky at a moment or over a span of time: right ascension and declination, brightness, distance, constellation and, for a place on Earth, its direction and height above the horizon. |
| List asteroid moons | List the known moons of asteroids and comets, or of one of them, with each moon's name, discovery year, orbit and size where known. |
| List close approaches | List asteroids and comets passing close to Earth (or another planet or the Moon) in a date range, with how close they come in lunar distances and kilometres, their speed and their likely size. |
| List fireballs | List fireballs (exceptionally bright meteors) detected by US Government sensors: when and where each one exploded, how high, how fast, and its energy in kilotons of TNT. |
| List human-accessible asteroids | List near-Earth asteroids a crewed round trip could reach within your mission limits (fuel, length, stay, launch years), from NASA's NHATS study: the cheapest and the shortest trip to each, its size, and when it can next be observed. |
| List impact risks | List the asteroids on NASA's Sentry risk list: objects with a possible (usually tiny) chance of hitting Earth in the next century or more, with their odds, hazard ratings, impact years and size. |
| List newly discovered objects | List objects discovered in the last few days that are waiting for confirmation, as JPL's Scout system rates them: how likely each is a near-Earth object, how close it may come, its impact rating and where it is in the sky. |
| List objects removed from the risk list | List the asteroids Sentry took off its risk list because new observations ruled out every impact, most recently removed first. |
| List radar observations | List radar measurements of asteroids and comets (distance by echo delay, speed by Doppler shift) from stations such as Goldstone and Arecibo, newest first. |
| List spacecraft mission targets | List the asteroids and comets a robotic spacecraft could reach most easily for launches in the years you choose, with the best launch and arrival dates, flight time and fuel (delta-v) for each. |
| List three-body periodic orbits | List periodic orbits of one family in a three-body system, such as halo orbits around the Earth-Moon L1 point, from JPL's catalog: starting position and velocity, period in days, and stability. |
| Search asteroids and comets | Find every asteroid or comet in JPL's Small-Body Database that matches your filters (kind, near-Earth or hazardous, orbit class, moons, and constraints such as 'diameter > 100'), returning the fields you choose. |
Convert date to Julian day
Turn a date and time (UTC) into its Julian day number, the count of days astronomers use, and its Modified Julian Date.
Inputs
- Date and time
date_timedate and timeRequired - The moment to convert (UTC).
Outputs
calendar_datetext- The date and time converted, UTC
day_of_weektext- Day of the week
day_of_yearnumber- Day of the year
julian_datenumber- The Julian day number
modified_julian_datenumber- The Modified Julian Date (Julian day - 2400000.5)
summarytext- One line describing the result
Example output
{
"calendar_date": "2026-10-19 14:30:15",
"day_of_week": "Monday",
"day_of_year": 292,
"julian_date": 2461333.1043403,
"modified_julian_date": 61332.6043403,
"summary": "2026-10-19 14:30:15 UTC is Julian day 2461333.1043403."
}Convert Julian day to date
Turn a Julian day number into its calendar date and time (UTC), day of the week and day of the year. Dates before 15 October 1582 are in the Julian calendar.
Inputs
- Julian day
julian_datenumberRequired - The Julian day number, such as 2451545.0 (noon on 1 January 2000).From -1931076.5 to 38245308.5.
- Precision
precisiontext - How precisely to give the time. Defaults to the nearest second.One of:
s(Nearest second),s.3(Milliseconds),m(Nearest minute),d(Nearest day).
Outputs
calendar_datetext- The date and time, UTC, e.g. 2000-01-01 12:30:45
datetext- The date, YYYY-MM-DD (the year can be negative)
day_of_weektext- Day of the week
day_of_yearnumber- Day of the year
isotext- The moment as ISO 8601, for years 0 to 9999
modified_julian_datenumber- The Modified Julian Date
monthnumber- Month number
month_nametext- Month, e.g. Jan
summarytext- One line describing the result
timetext- The time of day, UTC
yearnumber- Year
Example output
{
"calendar_date": "2000-01-01 12:30:45",
"date": "2000-01-01",
"day_of_week": "Saturday",
"day_of_year": 1,
"iso": "2000-01-01T12:30:45Z",
"modified_julian_date": 51544.5213542,
"month": 1,
"month_name": "Jan",
"summary": "Julian day 2451545.0213542 is Saturday 2000-01-01 12:30:45 UTC.",
"time": "12:30:45",
"year": 2000
}Find asteroids and comets in a sky area
List the known asteroids and comets inside a square patch of sky at a given time, as seen from an observatory or a place on Earth: their positions, brightness and motion. Useful for identifying something in a telescope image. Takes 20 seconds to a few minutes.
Inputs
- Time
observation_timedate and timeRequired - When the sky is observed (UTC).
- Right ascension (degrees)
right_ascension_degnumberRequired - The center of the area, 0 to 360 degrees (hours x 15).From 0 to 360.
- Declination (degrees)
declination_degnumberRequired - The center of the area, -90 to 90 degrees.From -90 to 90.
- Half-width (degrees)
half_width_degnumber - From the center to each edge, 0.01 to 10 degrees. Defaults to 0.5.From 0.01 to 10.
- Observatory code
observatory_codetext - The Minor Planet Center code of the observatory, such as 568 (Mauna Kea) or G96 (Mt. Lemmon). Or give a latitude and longitude instead.
- Latitude
latitudenumber - Your latitude in degrees, -90 to 90 (north is positive).From -90 to 90.
- Longitude
longitudenumber - Your longitude in degrees, -180 to 180 (east is positive).From -180 to 180.
- Altitude (km)
altitude_kmnumber - Your height above sea level in km, with a latitude and longitude.From -1 to 10.
- Faintest magnitude
max_magnitudenumber - Skip objects fainter than this V magnitude. Defaults to 20.From -30 to 40.
- Objects
grouptext - Which objects to look for. Defaults to all asteroids and comets.One of:
all(All asteroids and comets),neo(Near-Earth objects only),asteroids(Asteroids only),comets(Comets only). - Precise positions
precisetrue/false - Compute exact positions (slower) instead of a quick estimate.
Outputs
countnumber- How many are in this result
field_centertext- The center of the area, as JPL writes it
locationtext- Where the sky was seen from
objectslist- The objects found, nearest the center first
observation_timetext- The time used, as JPL writes it
summarytext- One line describing the result
Example output
{
"count": 1,
"field_center": "02:00:00.00, +10 00'00.00\" (J2000)",
"location": "Mauna Kea",
"objects": [
{
"dec_rate_arcsec_per_hour": 4.755,
"declination": "+09 56'27\"",
"distance_from_center_arcsec": 231.8,
"error_dec_arcsec": 49.85,
"error_ra_arcsec": 49.85,
"magnitude": 17.9,
"name": "90321 (2003 FZ67)",
"offset_dec_arcsec": -213.0,
"offset_ra_arcsec": 92.2,
"ra_rate_arcsec_per_hour": -43.06,
"right_ascension": "02:00:06"
}
],
"observation_time": "2026-Oct-19 08:00:00 (2461332.833333 UT)",
"summary": "1 known object in the 0.4\u00b0 field at RA 30\u00b0, Dec 10\u00b0 seen from Mauna Kea at 2026-10-19 08:00 UTC; nearest the center: 90321 (2003 FZ67)."
}Get asteroid or comet
Look up one asteroid or comet in JPL's Small-Body Database by name, number or designation: its orbit, orbit class, whether it is a near-Earth or potentially hazardous object, size, rotation, composition, discovery, moons and any possible Earth impacts.
Inputs
- Asteroid or comet
object_nametextRequired - A name, number or designation, such as Eros, 433, 2000 SG344 or 1P.
- Include close approaches
include_close_approachestrue/false - Also list its past and future close approaches to the planets.
Outputs
close_approacheslist- Its close approaches, when asked for
designationtext- Primary designation, e.g. 433 or 2000 SG344
discoveryobject- How it was discovered (numbered objects only)
is_neotrue/false- True for a near-Earth object
is_phatrue/false- True for a potentially hazardous asteroid
kindtext- numbered asteroid, unnumbered asteroid, numbered comet or unnumbered comet
nametext- Full name, e.g. 433 Eros (A898 PA)
orbitobject- Its orbit
orbit_classtext- Orbit class, e.g. Amor or Main-belt Asteroid
orbit_class_codetext- Orbit class code, e.g. AMO or MBA
physicalobject- Its main physical properties, where measured
physical_parameterslist- Every physical parameter JPL holds, with its source
potential_impactslist- Possible Earth impacts Sentry lists for it
satelliteslist- Its known moons
sbdb_urltext- The object's page in JPL's Small-Body Database Lookup
short_nametext- Short name, e.g. 433 Eros
spk_idtext- JPL's numeric id for it (SPK-ID)
summarytext- One line describing the result
Example output
{
"close_approaches": [
{
"approach_time": "2056-Jan-24 08:26",
"approach_time_iso": "2056-01-24T08:26:00Z",
"body": "Earth",
"distance_au": 0.15,
"distance_ld": 58.374,
"relative_velocity_km_s": 5.95
}
],
"designation": "433",
"discovery": {
"citation": null,
"date": "1898-Aug-13",
"discoverer": "Witt, G.",
"location": "Berlin",
"site": null,
"text": "Discovered 1898-08-13 by Witt, G. at Berlin"
},
"is_neo": true,
"is_pha": false,
"kind": "numbered asteroid",
"name": "433 Eros (A898 PA)",
"orbit": {
"aphelion_distance_au": 1.78,
"ascending_node_deg": 304.0,
"condition_code": 0,
"data_arc_days": 46582,
"earth_moid_au": 0.149,
"earth_moid_ld": 57.987,
"eccentricity": 0.223,
"epoch": "2026-Jun-09.0",
"epoch_jd": 2461200.5,
"first_observation": "1893-10-29",
"inclination_deg": 10.8,
"jupiter_moid_au": 3.3,
"last_observation": "2021-05-13",
"mean_anomaly_deg": 62.5,
"mean_motion_deg_per_day": 0.56,
"observations_used": 9130,
"orbit_id": "659",
"perihelion_argument_deg": 179.0,
"perihelion_distance_au": 1.13,
"perihelion_time": "2026-Feb-17.313",
"perihelion_time_jd": 2461088.813,
"period_days": 643.0,
"period_years": 1.76,
"semi_major_axis_au": 1.46,
"solution_date": "2021-05-24 17:55:05",
"tisserand_jupiter": 4.582
},
"orbit_class": "Amor",
"orbit_class_code": "AMO",
"physical": {
"absolute_magnitude": 10.4,
"albedo": 0.25,
"color_b_v": 0.921,
"color_u_b": 0.531,
"density_g_cm3": 2.67,
"diameter_km": 16.84,
"dimensions_km": "34.4x11.2x11.2",
"gm_km3_s2": 0.0004463,
"magnitude_slope": 0.46,
"pole_direction": "11.37/17.22",
"rotation_period_hours": 5.27,
"spectral_type_smassii": "S",
"spectral_type_tholen": "S"
},
"physical_parameters": [
{
"name": "diameter",
"reference": "Yeomans et al. (2000) Science v.289,pp.2085-2088",
"sigma": "0.06",
"title": "diameter",
"units": "km",
"value": "16.84"
}
],
"potential_impacts": [],
"satellites": [],
"sbdb_url": "https://ssd.jpl.nasa.gov/tools/sbdb_lookup.html#/?sstr=20000433",
"short_name": "433 Eros",
"spk_id": "20000433",
"summary": "433 Eros (A898 PA): numbered asteroid, Amor orbit, 1.76 year orbit, 16.84 km across, near-Earth object"
}Get human-accessible asteroid
Get the round trips NHATS found to one near-Earth asteroid: the cheapest and the shortest, each with its launch date, legs, stay and fuel needs. 'meets_limits' is false when no trip fits the limits given.
Inputs
- Asteroid or comet
designationtextRequired - Its number or designation, such as 99942, 2000 SG344 or 1P (a name like Apophis works only in 'Get asteroid or comet').
- Most delta-v
max_delta_vtext - The most total delta-v (fuel) a round trip may need. Defaults to 12 km/s.One of:
4(4 km/s),5(5 km/s),6(6 km/s),7(7 km/s),8(8 km/s),9(9 km/s),10(10 km/s),11(11 km/s),12(12 km/s). - Longest mission
max_duration_daystext - The longest a round trip may take. Defaults to 450 days.One of:
60(60 days),90(90 days),120(120 days),150(150 days),180(180 days),210(210 days),240(240 days),270(270 days),300(300 days),330(330 days), and 4 more. - Shortest stay
min_stay_daystext - The least time to spend at the asteroid. Defaults to 8 days.One of:
8(8 days),16(16 days),24(24 days),32(32 days). - Launch years
launch_windowtext - When the mission launches. Defaults to 2020 to 2045.One of:
2020-2045(2020 to 2045),2020-2025(2020 to 2025),2025-2030(2025 to 2030),2030-2035(2030 to 2035),2035-2040(2035 to 2040),2040-2045(2040 to 2045).
Outputs
absolute_magnitudenumber- Absolute magnitude H
computedtext- When NHATS computed the trajectories
designationtext- The asteroid's designation
diameter_mnumber- Measured diameter, metres, when known
max_diameter_mnumber- Largest likely diameter, metres
meets_limitstrue/false- False when no round trip meets the limits given
min_delta_v_duration_daysnumber- Length of that lowest delta-v round trip, days
min_delta_v_km_snumber- Lowest total delta-v of any round trip, km/s
min_delta_v_trajectoryobject- The round trip needing the least delta-v
min_diameter_mnumber- Smallest likely diameter, metres
min_duration_daysnumber- Shortest round trip, days
min_duration_delta_v_km_snumber- Delta-v of that shortest round trip, km/s
min_duration_trajectoryobject- The shortest round trip
nametext- Its full name
next_optical_magnitudenumber- Its brightness (V magnitude) in that window
next_optical_window_endtext- End of that window
next_optical_window_starttext- Start of the next good window to observe it with telescopes
next_radar_date_goldstonetext- Next date Goldstone radar could observe it
orbit_condition_codenumber- Orbit uncertainty, 0 (good) to 9 (poor)
sbdb_urltext- The object's page in JPL's Small-Body Database Lookup
summarytext- One line describing the result
viable_trajectoriesnumber- How many round trips meet the limits
Example output
{
"absolute_magnitude": 24.7,
"computed": "2021-04-19",
"designation": "2000 SG344",
"diameter_m": null,
"max_diameter_m": 89.0,
"meets_limits": true,
"min_delta_v_duration_days": 370,
"min_delta_v_km_s": 3.549,
"min_delta_v_trajectory": {
"arrival_delta_v_km_s": 0.137,
"asteroid_departure_delta_v_km_s": 0.166,
"departure_declination_deg": -11.923,
"departure_v_infinity_km_s": 1.227,
"earth_departure_delta_v_km_s": 3.246,
"earth_return_delta_v_km_s": 0.0,
"entry_speed_km_s": 11.15,
"launch_date": "2029-10-12",
"launch_energy_c3_km2_s2": 1.507,
"outbound_days": 201,
"return_days": 161,
"return_declination_deg": -13.06,
"stay_days": 8,
"total_delta_v_km_s": 3.549,
"total_duration_days": 370,
"trajectory_id": "2280521"
},
"min_diameter_m": 20.0,
"min_duration_days": 34,
"min_duration_delta_v_km_s": 11.402,
"min_duration_trajectory": {
"arrival_delta_v_km_s": 0.137,
"asteroid_departure_delta_v_km_s": 0.166,
"departure_declination_deg": -11.923,
"departure_v_infinity_km_s": 1.227,
"earth_departure_delta_v_km_s": 3.246,
"earth_return_delta_v_km_s": 0.0,
"entry_speed_km_s": 11.15,
"launch_date": "2028-04-08",
"launch_energy_c3_km2_s2": 1.507,
"outbound_days": 201,
"return_days": 161,
"return_declination_deg": -13.06,
"stay_days": 8,
"total_delta_v_km_s": 11.402,
"total_duration_days": 34,
"trajectory_id": "2280521"
},
"name": "(2000 SG344)",
"next_optical_magnitude": 19.11,
"next_optical_window_end": "2028-09-11",
"next_optical_window_start": "2028-04-28",
"next_radar_date_goldstone": "2028-05-07",
"orbit_condition_code": 3,
"sbdb_url": "https://ssd.jpl.nasa.gov/tools/sbdb_lookup.html#/?sstr=2000%20SG344",
"summary": "2000 SG344: cheapest round trip launches 2029-10-12, 3.549 km/s over 370 days.",
"viable_trajectories": 3302685
}Get impact risk
Get Sentry's impact assessment for one asteroid: every date it could hit Earth with the odds, hazard ratings and impact energy, plus its size and observation history. An object Sentry does not list comes back with 'on_risk_list' false, saying whether it was removed and when.
Inputs
- Asteroid or comet
designationtextRequired - Its number or designation, such as 99942, 2000 SG344 or 1P (a name like Apophis works only in 'Get asteroid or comet').
Outputs
absolute_magnitudenumber- Absolute magnitude H
computed_attext- When Sentry last analysed it (Pacific time)
designationtext- The object's designation
diameter_kmnumber- Estimated diameter, km
first_observedtext- Date of the first observation used
impact_energy_megatonsnumber- Impact energy in megatons of TNT
impact_probabilitynumber- Chance of any of its possible impacts, 0 to 1
impact_velocity_km_snumber- Speed at atmospheric entry, km/s
impactslist- Each possible impact
last_observedtext- Date of the last observation used
mass_kgnumber- Estimated mass, kg
methodtext- Sentry's analysis method, e.g. IOBS
nametext- Its full name
observation_arc_daysnumber- Days spanned by the observations
observationsnumber- Number of observations used
on_risk_listtrue/false- True while Sentry lists possible impacts for it
palermo_scale_cumulativenumber- Palermo scale over all possible impacts
palermo_scale_maxnumber- Palermo scale of its most threatening impact
potential_impactsnumber- How many possible impact dates Sentry found
removedtrue/false- True when it was on the list and later removed
removed_attext- When it was removed (UTC), if it was
sbdb_urltext- The object's page in JPL's Small-Body Database Lookup
summarytext- One line describing the result
torino_scale_maxnumber- Highest Torino scale rating, 0 to 10
velocity_infinity_km_snumber- Speed relative to Earth ignoring its gravity, km/s
Example output
{
"absolute_magnitude": 17.94,
"computed_at": "2026-10-06 11:25:37",
"designation": "29075",
"diameter_km": 1.3,
"first_observed": "1950-02-23",
"impact_energy_megatons": 75200.0,
"impact_probability": 0.0003633,
"impact_velocity_km_s": 17.97,
"impacts": [
{
"date": "2880-03-16.99",
"energy_megatons": 75200.0,
"impact_probability": 0.0003633,
"palermo_scale": -0.95,
"sigma": 4.0738,
"torino_scale": null
}
],
"last_observed": "2026-10-05",
"mass_kg": 1960000000000.0,
"method": "IOBS",
"name": "29075 (1950 DA)",
"observation_arc_days": 27983.0,
"observations": 1184,
"on_risk_list": true,
"palermo_scale_cumulative": -0.95,
"palermo_scale_max": -0.95,
"potential_impacts": 1,
"removed": false,
"removed_at": null,
"sbdb_url": "https://ssd.jpl.nasa.gov/tools/sbdb_lookup.html#/?sstr=29075",
"summary": "29075 (1950 DA): 1 in 2,753 of hitting Earth over 1 possible impact date, the first on 2880-03-16; Palermo -0.95.",
"torino_scale_max": null,
"velocity_infinity_km_s": 14.1
}Get newly discovered object
Get Scout's latest assessment of one newly discovered object by its temporary name. Objects leave Scout once they are confirmed and designated.
Inputs
- Temporary name
temporary_designationtextRequired - Its temporary name, such as P22rrse, from 'List newly discovered objects'.
Outputs
absolute_magnitudenumber- Absolute magnitude H (rough)
arc_hoursnumber- Hours between the first and last observation
close_approach_ldnumber- Closest approach to Earth, lunar distances (rough)
comet_scorenumber- Chance of a comet-like orbit, 0-100
declinationtext- Current declination, degrees
earth_moid_aunumber- Closest distance between its orbit and Earth's, au (rough)
ephemeris_timetext- Time the position fields refer to (UTC)
fit_rmsnumber- How well the orbit fits the observations (normalised RMS)
geocentric_scorenumber- Chance it orbits Earth (often space debris), 0-100
impact_ratingnumber- Scout's impact rating, 0 (negligible) to 4 (elevated)
impact_rating_labeltext- The rating in words: negligible, small, modest, moderate or elevated
interior_earth_scorenumber- Chance its orbit lies inside Earth's, 0-100
last_runtext- When Scout last analysed it (UTC)
magnitudenumber- Current brightness (V magnitude)
motion_arcsec_per_minnumber- How fast it moves across the sky, arcseconds per minute
neo_1km_scorenumber- Chance it is a near-Earth object over 1 km, 0-100
neo_scorenumber- Chance it is a near-Earth object, 0-100
observationsnumber- Observations so far
pha_scorenumber- Chance it is a potentially hazardous asteroid, 0-100
right_ascensiontext- Current right ascension, hh:mm
solar_elongation_degnumber- Angle from the Sun in the sky, degrees
summarytext- One line describing the result
temporary_designationtext- Its temporary name on the confirmation page, e.g. P22rrse
uncertainty_arcminnumber- Current position uncertainty (1-sigma), arcminutes
uncertainty_tomorrow_arcminnumber- Position uncertainty a day from now, arcminutes
velocity_infinity_km_snumber- Speed relative to Earth, km/s
Example output
{
"absolute_magnitude": 23.4,
"arc_hours": 0.5,
"close_approach_ld": 12.0,
"comet_score": 35,
"declination": "+18",
"earth_moid_au": 0.08,
"ephemeris_time": "2026-10-20 00:00",
"fit_rms": 0.14,
"geocentric_score": 0,
"impact_rating": 0,
"impact_rating_label": "negligible",
"interior_earth_score": 0,
"last_run": "2026-10-19 22:12",
"magnitude": 21.0,
"motion_arcsec_per_min": 6.3,
"neo_1km_score": 0,
"neo_score": 94,
"observations": 3,
"pha_score": 1,
"right_ascension": "03:24",
"solar_elongation_deg": 153.0,
"summary": "P22rrse: 94% likely a near-Earth object, may pass within 12 lunar distances, impact rating negligible",
"temporary_designation": "P22rrse",
"uncertainty_arcmin": 4.2,
"uncertainty_tomorrow_arcmin": 34.0,
"velocity_infinity_km_s": null
}Get position in space
Get where a body is in space, as X, Y and Z position and velocity relative to the Sun, Earth or another center, at a moment or over a span of time, with its distance and light time. From JPL's Horizons system.
Inputs
- Body
targettextRequired - Pick the Sun, a planet, a moon or a spacecraft, or type any asteroid, comet or body Horizons knows: Apophis, 2024 YR4, C/2023 A3, or an id such as 499.
- Relative to
centertext - The center the position is measured from. Defaults to the Sun.One of:
500@10(Sun),500@0(Solar System barycenter),500@399(Earth),500@301(Moon),500@499(Mars),500@599(Jupiter). - From
startdate and time - The first moment (UTC). Leave 'Until' blank for this one moment. Blank means now.
- Until
stopdate and time - The last moment (UTC), for a table over a span of time.
- Every
step_sizenumber - The gap between rows, with 'Step unit'. Defaults to 1. At most 500 rows.From 1 to 100000.
- Step unit
step_unittext - Minutes, hours or days. Defaults to days.One of:
m(Minutes),h(Hours),d(Days). - Units
unitstext - Astronomical units and au/day, or km and km/s. Defaults to au.One of:
AU-D(Astronomical units and au/day),KM-S(Kilometres and km/s). - Reference plane
reference_planetext - The plane X and Y lie in. Defaults to the ecliptic.One of:
ECLIPTIC(Ecliptic (the plane of Earth's orbit)),FRAME(Earth's equator (ICRF)).
Outputs
centertext- The center, e.g. Sun
countnumber- How many are in this result
distance_unittext- au or km
speed_unittext- au/day or km/s
summarytext- One line describing the result
targettext- The body, as Horizons names it
target_idtext- The body's Horizons id
vectorslist- One row per moment (TDB)
Example output
{
"center": "Sun",
"count": 1,
"distance_unit": "au",
"speed_unit": "au/day",
"summary": "Earth is 0.996212 au from the Sun at 2026-10-19 00:00 TDB.",
"target": "Earth",
"target_id": "399",
"vectors": [
{
"distance": 0.9962121831279669,
"julian_date_tdb": 2461332.5,
"light_time": 0.005753641725656441,
"range_rate": -0.0002863822685707341,
"time_iso": "2026-10-19T00:00:00Z",
"time_tdb": "2026-Oct-19 00:00:00.0000",
"vx": -0.007624353454157118,
"vy": 0.01549229503382759,
"vz": -1.45245444532166e-06,
"x": 0.9010052432373891,
"y": 0.4250038406545623,
"z": -3.000324072405501e-05
}
]
}Get sky position
Find where the Sun, a planet, a moon, a spacecraft, an asteroid or a comet appears in the sky at a moment or over a span of time: right ascension and declination, brightness, distance, constellation and, for a place on Earth, its direction and height above the horizon. From JPL's Horizons system.
Inputs
- Body
targettextRequired - Pick the Sun, a planet, a moon or a spacecraft, or type any asteroid, comet or body Horizons knows: Apophis, 2024 YR4, C/2023 A3, or an id such as 499.
- From
startdate and time - The first moment (UTC). Leave 'Until' blank for this one moment. Blank means now.
- Until
stopdate and time - The last moment (UTC), for a table over a span of time.
- Every
step_sizenumber - The gap between rows, with 'Step unit'. Defaults to 1. At most 500 rows.From 1 to 100000.
- Step unit
step_unittext - Minutes, hours or days. Defaults to days.One of:
m(Minutes),h(Hours),d(Days). - Latitude
latitudenumber - Your latitude, -90 to 90. Leave blank to see from Earth's center.From -90 to 90.
- Longitude
longitudenumber - Your longitude, -180 to 180 (east is positive).From -180 to 180.
- Elevation (m)
elevation_mnumber - Your height above sea level in metres.From -500 to 10000.
Outputs
countnumber- How many are in this result
observertext- Where it is seen from
positionslist- One row per moment
summarytext- One line describing the result
targettext- The body, as Horizons names it
target_idtext- The body's Horizons id
Example output
{
"count": 1,
"observer": "38.89, -77.03",
"positions": [
{
"azimuth_deg": 355.258366,
"constellation": "Cancer",
"constellation_code": "Cnc",
"dec_deg": 18.63198,
"declination": "+18\u00b0 37\u2032 55.1\u2033",
"distance_au": 1.53492737091502,
"distance_km": 229621866,
"elevation_deg": -32.445419,
"illuminated_percent": 89.78624,
"magnitude": 0.986,
"nuclear_magnitude": null,
"ra_deg": 134.29506,
"range_rate_km_s": -13.1911125,
"right_ascension": "08h 57m 10.81s",
"sky": "morning sky",
"solar_elongation_deg": 73.8057,
"sun": "night",
"surface_brightness": 4.533,
"time": "2026-Oct-19 00:00",
"time_iso": "2026-10-19T00:00:00Z"
}
],
"summary": "Mars at 2026-10-19 00:00 UTC: RA 08h 57m 10.81s, Dec +18\u00b0 37\u2032 55.1\u2033, 32.4\u00b0 below the horizon, magnitude 0.986, in Cancer.",
"target": "Mars",
"target_id": "499"
}List asteroid moons
List the known moons of asteroids and comets, or of one of them, with each moon's name, discovery year, orbit and size where known.
Inputs
- Asteroid or comet
designationtext - Only the moons of this one, such as 22 (Kalliope) or 65803 (Didymos).
- Object type
object_typetext - Only moons of asteroids, numbered or unnumbered asteroids, or comets.One of:
a(Asteroids),an(Numbered asteroids),au(Unnumbered asteroids),c(Comets). - Confirmed
confirmedtext - Only confirmed or only unconfirmed moons. Leave blank with one asteroid.One of:
Y(Confirmed only),N(Unconfirmed only). - Maximum results
limitnumber - How many to return, 1 to 1000.From 1 to 1000.
Outputs
countnumber- How many are in this result
moonslist- The moons
summarytext- One line describing the result
totalnumber- How many match in all, before the limit
Example output
{
"count": 1,
"moons": [
{
"confirmed": true,
"density_g_cm3": null,
"diameter_km": null,
"discovery_year": 2001,
"iau_name": "Linus",
"name": "(22) Kalliope I Linus",
"notes": null,
"orbit": {
"eccentricity": null,
"inclination_deg": 93.4,
"period_hours": 86.296,
"reference": "Margot and Brown (2003), Science 300",
"semi_major_axis_km": 1063.0
},
"primary_designation": "22",
"primary_name": "22 Kalliope (A852 WA)",
"primary_orbit_class": "Main-belt Asteroid",
"reference": "Merline and Menard (2001), IAUC 7703",
"rotation_period_hours": null
}
],
"summary": "1 moon of 1 asteroid or comet (showing 1); first: (22) Kalliope I Linus.",
"total": 1
}List close approaches
List asteroids and comets passing close to Earth (or another planet or the Moon) in a date range, with how close they come in lunar distances and kilometres, their speed and their likely size. Leave the dates blank for the next 60 days.
Inputs
- From
from_datedate - The first day to include. Defaults to today.
- Until
to_datedate - The last day to include. Defaults to 60 days after 'From'.
- Closer than (lunar distances)
max_distance_ldnumber - Only approaches nearer than this many lunar distances (1 is the Moon's distance, about 384,400 km). Defaults to about 19.5.From 0.001 to 20000.
- Passing
bodytext - The planet or moon they pass. Defaults to Earth.One of:
Earth,Moon,Merc(Mercury),Venus,Mars,Juptr(Jupiter),Satrn(Saturn),Urnus(Uranus),Neptn(Neptune),Pluto,ALL(Any planet or the Moon). - Objects
grouptext - Which objects to include. Defaults to near-Earth objects.One of:
neo(Near-Earth objects),pha(Potentially hazardous asteroids),nea(Near-Earth asteroids),comet(Comets),all(Any asteroid or comet). - Only this object
designationtext - A number or designation, such as 99942 or 2000 SG344.
- Brightest magnitude (H)
max_absolute_magnitudenumber - Only objects with an absolute magnitude H at most this; lower H is bigger (H 22 is roughly 140 m or more).From -5 to 40.
- Order
sorttext - Defaults to soonest first.One of:
date(Soonest first),-date(Latest first),dist(Closest first),h(Largest first),-v-rel(Fastest first). - Maximum results
limitnumber - How many to return, 1 to 1000.From 1 to 1000.
Outputs
close_approacheslist- The close approaches
countnumber- How many are in this result
summarytext- One line describing the result
totalnumber- How many match in all, before the limit
Example output
{
"close_approaches": [
{
"absolute_magnitude": 27.177,
"approach_time": "2026-Oct-12 15:25",
"approach_time_iso": "2026-10-12T15:25:00Z",
"body": "Earth",
"designation": "2026 TN77",
"diameter_km": null,
"distance_au": 0.00037043,
"distance_km": 55416,
"distance_ld": 0.144,
"estimated_diameter_max_m": 21.8,
"estimated_diameter_min_m": 9.8,
"julian_date": 2461326.142275298,
"max_distance_ld": 0.145,
"min_distance_ld": 0.144,
"name": "(2026 TN77)",
"orbit_id": "3",
"relative_velocity_km_s": 15.302,
"sbdb_url": "https://ssd.jpl.nasa.gov/tools/sbdb_lookup.html#/?sstr=2026%20TN77",
"summary": "2026 TN77 comes within 0.144 lunar distances (55,416 km) of Earth on 2026-Oct-12 15:25 TDB at 15.302 km/s, about 9.8-21.8 m across",
"time_uncertainty": "00:04",
"velocity_infinity_km_s": 14.824
}
],
"count": 1,
"summary": "1 close approach match (showing all). Closest: 2026 TN77 at 0.144 lunar distances on 2026-Oct-12 15:25.",
"total": 1
}List fireballs
List fireballs (exceptionally bright meteors) detected by US Government sensors: when and where each one exploded, how high, how fast, and its energy in kilotons of TNT. Newest first.
Inputs
- From
from_datedate - Only fireballs on or after this day.
- Until
to_datedate - Only fireballs on or before this day.
- At least (kilotons)
min_impact_energy_ktnumber - Only fireballs with at least this impact energy, in kilotons of TNT.At least 0.
- Only with a location
require_locationtrue/false - Skip fireballs reported without a latitude and longitude.
- Only with an altitude
require_altitudetrue/false - Skip fireballs reported without a height.
- Order
sorttext - Defaults to newest first.One of:
-date(Newest first),date(Oldest first),-impact-e(Most energetic first),-vel(Fastest first),-alt(Highest first). - Maximum results
limitnumber - How many to return, 1 to 1000. Defaults to 20.From 1 to 1000.
Outputs
countnumber- How many are in this result
fireballslist- The fireballs
summarytext- One line describing the result
Example output
{
"count": 1,
"fireballs": [
{
"altitude_km": 26.9,
"date": "2026-10-04 03:14:45",
"date_iso": "2026-10-04T03:14:45Z",
"impact_energy_kt": 0.18,
"latitude": -41.8,
"location": "41.8\u00b0S, 173.1\u00b0W",
"longitude": -173.1,
"radiated_energy_joules": 54000000000.0,
"summary": "Fireball on 2026-10-04 03:14:45 UTC over 41.8\u00b0S, 173.1\u00b0W, about 0.18 kt of TNT, 26.9 km up, 13.8 km/s",
"velocity_km_s": 13.8,
"velocity_x_km_s": 14.8,
"velocity_y_km_s": 2.9,
"velocity_z_km_s": 2.2
}
],
"summary": "1 fireball; the most recent was on 2026-10-04 03:14:45 UTC."
}List human-accessible asteroids
List near-Earth asteroids a crewed round trip could reach within your mission limits (fuel, length, stay, launch years), from NASA's NHATS study: the cheapest and the shortest trip to each, its size, and when it can next be observed.
Inputs
- Most delta-v
max_delta_vtext - The most total delta-v (fuel) a round trip may need. Defaults to 12 km/s.One of:
4(4 km/s),5(5 km/s),6(6 km/s),7(7 km/s),8(8 km/s),9(9 km/s),10(10 km/s),11(11 km/s),12(12 km/s). - Longest mission
max_duration_daystext - The longest a round trip may take. Defaults to 450 days.One of:
60(60 days),90(90 days),120(120 days),150(150 days),180(180 days),210(210 days),240(240 days),270(270 days),300(300 days),330(330 days), and 4 more. - Shortest stay
min_stay_daystext - The least time to spend at the asteroid. Defaults to 8 days.One of:
8(8 days),16(16 days),24(24 days),32(32 days). - Launch years
launch_windowtext - When the mission launches. Defaults to 2020 to 2045.One of:
2020-2045(2020 to 2045),2020-2025(2020 to 2025),2025-2030(2025 to 2030),2030-2035(2030 to 2035),2035-2040(2035 to 2040),2040-2045(2040 to 2045). - Brightest magnitude (H)
max_absolute_magnitudetext - Only asteroids with H at most this (lower H is bigger).One of:
16(H 16),17(H 17),18(H 18),19(H 19),20(H 20),21(H 21),22(H 22),23(H 23),24(H 24),25(H 25), and 5 more. - Orbit uncertainty at most
max_orbit_condition_codetext - Only asteroids whose orbit is known at least this well (0 is best).One of:
0,1,2,3,4,5,6,7,8. - Order
sorttext - Defaults to lowest delta-v first.One of:
delta_v(Lowest delta-v first),duration(Shortest mission first),trajectories(Most mission options first),size(Largest first). - Maximum results
limitnumber - How many to return, 1 to 5000. Defaults to 50.From 1 to 5000.
Outputs
asteroidslist- The accessible asteroids
countnumber- How many are in this result
summarytext- One line describing the result
totalnumber- How many match in all, before the limit
Example output
{
"asteroids": [
{
"absolute_magnitude": 24.7,
"designation": "2000 SG344",
"diameter_m": null,
"max_diameter_m": 89.0,
"min_delta_v_duration_days": 370,
"min_delta_v_km_s": 3.549,
"min_diameter_m": 20.0,
"min_duration_days": 34,
"min_duration_delta_v_km_s": 11.402,
"name": "(2000 SG344)",
"next_optical_magnitude": 19.11,
"next_optical_window_end": "2028-09-11",
"next_optical_window_start": "2028-04-28",
"next_radar_date_goldstone": "2028-05-07",
"orbit_condition_code": 3,
"sbdb_url": "https://ssd.jpl.nasa.gov/tools/sbdb_lookup.html#/?sstr=2000%20SG344",
"summary": "2000 SG344: round trip from 3.549 km/s delta-v (370 days), shortest 34 days; 20-89 m across",
"viable_trajectories": 3302685
}
],
"count": 1,
"summary": "622 accessible asteroids (showing 1); first: 2000 SG344: round trip from 3.549 km/s delta-v (370 days), shortest 34 days; 20-89 m across.",
"total": 622
}List impact risks
List the asteroids on NASA's Sentry risk list: objects with a possible (usually tiny) chance of hitting Earth in the next century or more, with their odds, hazard ratings, impact years and size. Highest hazard first.
Inputs
- Palermo scale at least
min_palermo_scalenumber - Only objects rated at least this on the Palermo hazard scale, -20 to 20 (below -2 is no concern; above 0 merits attention).From -20 to 20.
- Impact probability at least
min_impact_probabilitynumber - Only objects at least this likely to hit, e.g. 0.0001 for 1 in 10,000.From 1e-10 to 1.
- Brightest magnitude (H)
max_absolute_magnitudenumber - Only objects with H at most this; lower H is bigger.From -10 to 100.
- Observed in the last (days)
observed_within_daysnumber - Only objects observed in the last this many days (more than 6). A negative number means not observed for that long.
- Order
sorttext - Defaults to highest hazard first.One of:
palermo(Highest hazard (Palermo scale) first),probability(Most likely impact first),year(Soonest possible impact first),size(Largest first),observed(Most recently observed first). - Maximum results
limitnumber - How many to return, 1 to 5000. Defaults to 50.From 1 to 5000.
Outputs
countnumber- How many are in this result
objectslist- The objects on the risk list
summarytext- One line describing the result
totalnumber- How many match in all, before the limit
Example output
{
"count": 1,
"objects": [
{
"absolute_magnitude": 20.63,
"designation": "101955",
"diameter_km": 0.49,
"first_year": 2178,
"impact_probability": 0.0005717,
"last_observed": "2020-10-3.80160",
"last_year": 2290,
"name": "101955 Bennu (1999 RQ36)",
"palermo_scale_cumulative": -1.4,
"palermo_scale_max": -1.58,
"potential_impacts": 157,
"sbdb_url": "https://ssd.jpl.nasa.gov/tools/sbdb_lookup.html#/?sstr=101955",
"summary": "101955 Bennu (1999 RQ36): 1 in 1,749 of hitting Earth (157 possible impacts, 2178-2290), Palermo scale -1.4",
"torino_scale_max": null,
"velocity_infinity_km_s": 5.992,
"years": "2178-2290"
}
],
"summary": "2,222 objects on the risk list match (showing 1); top: 101955 Bennu (1999 RQ36): 1 in 1,749 of hitting Earth (157 possible impacts, 2178-2290), Palermo scale -1.4.",
"total": 2222
}List newly discovered objects
List objects discovered in the last few days that are waiting for confirmation, as JPL's Scout system rates them: how likely each is a near-Earth object, how close it may come, its impact rating and where it is in the sky.
Inputs
- NEO likelihood at least
min_neo_scorenumber - Only objects at least this likely (0-100) to be near-Earth objects.From 0 to 100.
- Order
sorttext - Defaults to most recently updated first.One of:
updated(Most recently updated first),neo_score(Most likely near-Earth object first),rating(Highest impact rating first),closest(Closest approach first),brightest(Brightest first). - Maximum results
limitnumber - How many to return, 1 to 500. Defaults to 100.From 1 to 500.
Outputs
countnumber- How many are in this result
objectslist- The new objects
summarytext- One line describing the result
totalnumber- How many match in all, before the limit
Example output
{
"count": 1,
"objects": [
{
"absolute_magnitude": 23.4,
"arc_hours": 0.5,
"close_approach_ld": 12.0,
"comet_score": 35,
"declination": "+18",
"earth_moid_au": 0.08,
"ephemeris_time": "2026-10-20 00:00",
"fit_rms": 0.14,
"geocentric_score": 0,
"impact_rating": 0,
"impact_rating_label": "negligible",
"interior_earth_score": 0,
"last_run": "2026-10-19 22:12",
"magnitude": 21.0,
"motion_arcsec_per_min": 6.3,
"neo_1km_score": 0,
"neo_score": 94,
"observations": 3,
"pha_score": 1,
"right_ascension": "03:24",
"solar_elongation_deg": 153.0,
"summary": "P22rrse: 94% likely a near-Earth object, may pass within 12 lunar distances, impact rating negligible",
"temporary_designation": "P22rrse",
"uncertainty_arcmin": 4.2,
"uncertainty_tomorrow_arcmin": 34.0,
"velocity_infinity_km_s": null
}
],
"summary": "55 new objects awaiting confirmation (showing 1); first: P22rrse: 94% likely a near-Earth object, may pass within 12 lunar distances, impact rating negligible.",
"total": 55
}List objects removed from the risk list
List the asteroids Sentry took off its risk list because new observations ruled out every impact, most recently removed first.
Inputs
- Removed since
sincedate - Only objects removed on or after this day.
- Maximum results
limitnumber - How many to return, 1 to 5000. Defaults to 50.From 1 to 5000.
Outputs
countnumber- How many are in this result
objectslist- The removed objects
summarytext- One line describing the result
totalnumber- How many match in all, before the limit
Example output
{
"count": 1,
"objects": [
{
"designation": "2026 TM6",
"removed_at": "2026-10-19 14:52:36",
"removed_at_iso": "2026-10-19T14:52:36Z"
}
],
"summary": "13 objects removed since 2026-10-01 (showing 1); latest: 2026 TM6 on 2026-10-19 14:52:36 UTC.",
"total": 13
}List radar observations
List radar measurements of asteroids and comets (distance by echo delay, speed by Doppler shift) from stations such as Goldstone and Arecibo, newest first.
Inputs
- Only this object
designationtext - A number or designation, such as 433 or 2004 VB.
- Object type
object_typetext - Only asteroids, numbered or unnumbered asteroids, or comets.One of:
a(Asteroids),an(Numbered asteroids),au(Unnumbered asteroids),c(Comets). - Measurement
measurement_typetext - Only delay (distance) or only Doppler (speed) measurements.One of:
R(Delay (distance)),P(Doppler (speed)). - Maximum results
limitnumber - How many to return, 1 to 5000. Defaults to 100.From 1 to 5000.
Outputs
countnumber- How many are in this result
observationslist- The measurements, newest first
summarytext- One line describing the result
totalnumber- How many match in all, before the limit
Example output
{
"count": 1,
"observations": [
{
"bounce_point": "center of mass",
"designation": "433",
"epoch": "2019-01-08 10:50:00",
"epoch_iso": "2019-01-08T10:50:00Z",
"frequency_mhz": 8560.0,
"measurement": "delay",
"name": "433 Eros (A898 PA)",
"notes": "GSSR, delay correction based on 20 and 25 usec bauds and 15 length code.",
"observers": "M. Brozovic,S. P. Naidu,L. A. M. Benner",
"receiver": "DSS-14 (70-m)",
"receiver_code": "-14",
"sigma": 20.0,
"transmitter": "DSS-14 (70-m)",
"transmitter_code": "-14",
"units": "us",
"value": 210312110.7
}
],
"summary": "6 radar measurements of 1 object (showing 1); latest: 433 on 2019-01-08 10:50:00 UTC.",
"total": 6
}List spacecraft mission targets
List the asteroids and comets a robotic spacecraft could reach most easily for launches in the years you choose, with the best launch and arrival dates, flight time and fuel (delta-v) for each.
Inputs
- First launch year
first_launch_yearnumber - Defaults to this year.From 1950 to 2100.
- Last launch year
last_launch_yearnumber - Defaults to four years after the first. At most 21 years in all.From 1950 to 2100.
- Best means
criteriontext - How missions are ranked. Defaults to lowest launch energy.One of:
1(Lowest launch energy (departure V-infinity)),2(Slowest arrival (arrival V-infinity)),3(Lowest total delta-v),4(Shortest flight, then lowest launch energy),5(Shortest flight, then slowest arrival),6(Shortest flight, then lowest total delta-v). - Group
grouptext - Only near-Earth objects, or only potentially hazardous asteroids.One of:
neo(Near-Earth objects),pha(Potentially hazardous asteroids). - Orbit classes
orbit_classeslist - Only these orbit classes.One or more of:
IEO(Atira (inside Earth's orbit)),ATE(Aten),APO(Apollo),AMO(Amor),MCA(Mars-crossing asteroid),IMB(Inner main-belt asteroid),MBA(Main-belt asteroid),OMB(Outer main-belt asteroid),TJN(Jupiter Trojan),AST(Other asteroid), and 12 more. - Maximum results
limitnumber - How many to return, 1 to 1000. Defaults to 50.From 1 to 1000.
Outputs
countnumber- How many are in this result
launch_yearstext- The launch years searched, e.g. 2027-2029
summarytext- One line describing the result
targetslist- The targets, best first
Example output
{
"count": 1,
"launch_years": "2027-2029",
"summary": "1 target for launches in 2027-2029; best: 292220 (2006 SU49), launch 2027-04-05, arrive 2029-01-24 (5.064 km/s total delta-v).",
"targets": [
{
"absolute_magnitude": 19.39,
"arrival_date": "2029-01-24",
"arrival_v_infinity_km_s": 5.061,
"condition_code": 0,
"departure_date": "2027-04-05",
"departure_v_infinity_km_s": 0.003,
"designation": "292220",
"flight_time_days": 660,
"is_binary": false,
"is_neo": true,
"is_pha": true,
"launch_energy_c3_km2_s2": 9e-06,
"name": "292220 (2006 SU49)",
"orbit_class": "APO",
"sbdb_url": "https://ssd.jpl.nasa.gov/tools/sbdb_lookup.html#/?sstr=292220",
"total_delta_v_km_s": 5.064
}
]
}List three-body periodic orbits
List periodic orbits of one family in a three-body system, such as halo orbits around the Earth-Moon L1 point, from JPL's catalog: starting position and velocity, period in days, and stability.
Inputs
- System
systemtextRequired - The two bodies, such as Earth-Moon.One of:
earth-moon,sun-earth,sun-mars,mars-phobos,jupiter-europa,saturn-enceladus,saturn-titan. - Orbit family
familytextRequired - The kind of orbit. The labels say which also need a libration point or branch.One of:
halo(Halo (L1, L2 or L3; north or south branch)),lyapunov(Lyapunov (L1, L2 or L3)),vertical(Vertical (any libration point)),axial(Axial (any libration point)),longp(Long-period (L4 or L5)),short(Short-period (L4 or L5)),dro(Distant retrograde (DRO)),dpo(Distant prograde (DPO)),lpo(Low prograde (LPO; east or west branch)),butterfly(Butterfly (north or south branch)),dragonfly(Dragonfly (north or south branch)),resonant(Resonant (branch such as 21 for 2:1)). - Libration point
libration_pointtext - Required for halo, Lyapunov, vertical, axial, long- and short-period orbits.One of:
1(L1),2(L2),3(L3),4(L4),5(L5). - Branch
branchtext - N or S for halo, butterfly and dragonfly; E or W for low prograde; digits such as 21 (2:1) for resonant orbits.
- Shortest period (days)
min_period_daysnumber - Only orbits with at least this period.At least 0.
- Longest period (days)
max_period_daysnumber - Only orbits with at most this period.At least 0.
- Stable only
stable_onlytrue/false - Only stable orbits (stability index 1 or less).
- Maximum results
limitnumber - How many to return, 1 to 1000. Defaults to 20.From 1 to 1000.
Outputs
branchtext- The branch, if any
countnumber- How many are in this result
familytext- The orbit family
length_unit_kmnumber- The normalised length unit in km (the distance between the bodies)
libration_pointtext- The libration point, if any
mass_rationumber- Mass of the smaller body over the total
orbitslist- The orbits
summarytext- One line describing the result
systemtext- The system, e.g. Earth-Moon
time_unit_secondsnumber- The normalised time unit in seconds
totalnumber- How many match in all, before the limit
Example output
{
"branch": "N",
"count": 1,
"family": "halo",
"length_unit_km": 389703.264829278,
"libration_point": "1",
"mass_ratio": 0.01215058560962404,
"orbits": [
{
"jacobi_constant": 0.195162730858155,
"period": 3.123314392276159,
"period_days": 13.8446,
"stability_index": 243.405726813375,
"stable": false,
"vx": 0.0,
"vy": 1.4076145460136695,
"vz": 0.0,
"x": -0.4145618480314011,
"x_km": -161556.1,
"y": 0.0,
"z": 0.9075312043329506,
"z_km": 353667.9
}
],
"summary": "5731 halo orbits in the Earth-Moon system (showing 1); first has a 13.8446-day period.",
"system": "Earth-Moon",
"time_unit_seconds": 382981.289129055,
"total": 5731
}Search asteroids and comets
Find every asteroid or comet in JPL's Small-Body Database that matches your filters (kind, near-Earth or hazardous, orbit class, moons, and constraints such as 'diameter > 100'), returning the fields you choose.
Inputs
- Fields
fieldslist - The fields to return for each object. Defaults to name, class, size and orbit basics.One or more of:
spkid(SPK-ID),full_name(Full name),pdes(Primary designation),name(IAU name),prefix(Comet prefix),kind(Kind (an, au, cn, cu)),class(Orbit class),neo(Near-Earth object),pha(Potentially hazardous),H(Absolute magnitude (H)), and 35 more. - Object type
object_typetext - Asteroids or comets. Leave blank for both.One of:
a(Asteroids),c(Comets). - Numbered
numberedtext - Only numbered (well-observed) or only unnumbered objects.One of:
n(Numbered only),u(Unnumbered only). - Group
grouptext - Only near-Earth objects, or only potentially hazardous asteroids.One of:
neo(Near-Earth objects),pha(Potentially hazardous asteroids). - Orbit classes
orbit_classeslist - Only these orbit classes.One or more of:
IEO(Atira (inside Earth's orbit)),ATE(Aten),APO(Apollo),AMO(Amor),MCA(Mars-crossing asteroid),IMB(Inner main-belt asteroid),MBA(Main-belt asteroid),OMB(Outer main-belt asteroid),TJN(Jupiter Trojan),AST(Other asteroid), and 12 more. - Only with moons
has_satellitestrue/false - Only objects with at least one known moon.
- Leave out comet fragments
exclude_fragmentstrue/false - Skip fragments of broken-up comets.
- Constraints
constraintstext - One per line, all of which must hold, e.g. 'diameter > 100', 'i between 5 and 10', 'albedo defined', 'spec_B matches ^C'. Fields include H, diameter, albedo, rot_per, a, e, i, q, moid.
- Sort by
sorttext - Up to three field names, with - for descending, e.g. -diameter or H.
- Maximum results
limitnumber - How many to return, 1 to 1000. Defaults to 50.From 1 to 1000.
- Skip
offsetnumber - How many matches to skip, to page through a long list.At least 0.
Outputs
bodieslist- The matching objects, keyed by the fields asked for (the default fields shown)
countnumber- How many are in this result
fieldslist- The fields each object carries
summarytext- One line describing the result
totalnumber- How many match in all, before the limit
Example output
{
"bodies": [
{
"H": 3.34,
"a": 2.766,
"albedo": 0.09,
"class": "MBA",
"diameter": 939.4,
"e": 0.0797,
"full_name": "1 Ceres (A801 AA)",
"i": 10.59,
"moid_ld": 615.0,
"name": "Ceres",
"neo": false,
"pdes": "1",
"pha": false
}
],
"count": 1,
"fields": [
"full_name",
"pdes",
"name",
"class",
"neo",
"pha",
"H",
"diameter",
"albedo",
"a",
"e",
"i",
"moid_ld"
],
"summary": "9 asteroids and comets match (showing 1); first: 1 Ceres (A801 AA).",
"total": 9
}