# JPL Solar System Dynamics

> 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.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/jpl-ssd

## Actions

### 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_time`, date and time, required): The moment to convert (UTC).

**Outputs**

- `calendar_date` (text): The date and time converted, UTC
- `day_of_week` (text): Day of the week
- `day_of_year` (number): Day of the year
- `julian_date` (number): The Julian day number
- `modified_julian_date` (number): The Modified Julian Date (Julian day - 2400000.5)
- `summary` (text): One line describing the result

**Example output**

```json
{
  "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_date`, number, required): The Julian day number, such as 2451545.0 (noon on 1 January 2000). From -1931076.5 to 38245308.5.
- Precision (`precision`, text): 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_date` (text): The date and time, UTC, e.g. 2000-01-01 12:30:45
- `date` (text): The date, YYYY-MM-DD (the year can be negative)
- `day_of_week` (text): Day of the week
- `day_of_year` (number): Day of the year
- `iso` (text): The moment as ISO 8601, for years 0 to 9999
- `modified_julian_date` (number): The Modified Julian Date
- `month` (number): Month number
- `month_name` (text): Month, e.g. Jan
- `summary` (text): One line describing the result
- `time` (text): The time of day, UTC
- `year` (number): Year

**Example output**

```json
{
  "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_time`, date and time, required): When the sky is observed (UTC).
- Right ascension (degrees) (`right_ascension_deg`, number, required): The center of the area, 0 to 360 degrees (hours x 15). From 0 to 360.
- Declination (degrees) (`declination_deg`, number, required): The center of the area, -90 to 90 degrees. From -90 to 90.
- Half-width (degrees) (`half_width_deg`, number): From the center to each edge, 0.01 to 10 degrees. Defaults to 0.5. From 0.01 to 10.
- Observatory code (`observatory_code`, text): 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 (`latitude`, number): Your latitude in degrees, -90 to 90 (north is positive). From -90 to 90.
- Longitude (`longitude`, number): Your longitude in degrees, -180 to 180 (east is positive). From -180 to 180.
- Altitude (km) (`altitude_km`, number): Your height above sea level in km, with a latitude and longitude. From -1 to 10.
- Faintest magnitude (`max_magnitude`, number): Skip objects fainter than this V magnitude. Defaults to 20. From -30 to 40.
- Objects (`group`, text): 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 (`precise`, true/false): Compute exact positions (slower) instead of a quick estimate.

**Outputs**

- `count` (number): How many are in this result
- `field_center` (text): The center of the area, as JPL writes it
- `location` (text): Where the sky was seen from
- `objects` (list): The objects found, nearest the center first
- `observation_time` (text): The time used, as JPL writes it
- `summary` (text): One line describing the result

**Example output**

```json
{
  "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_name`, text, required): A name, number or designation, such as Eros, 433, 2000 SG344 or 1P.
- Include close approaches (`include_close_approaches`, true/false): Also list its past and future close approaches to the planets.

**Outputs**

- `close_approaches` (list): Its close approaches, when asked for
- `designation` (text): Primary designation, e.g. 433 or 2000 SG344
- `discovery` (object): How it was discovered (numbered objects only)
- `is_neo` (true/false): True for a near-Earth object
- `is_pha` (true/false): True for a potentially hazardous asteroid
- `kind` (text): numbered asteroid, unnumbered asteroid, numbered comet or unnumbered comet
- `name` (text): Full name, e.g. 433 Eros (A898 PA)
- `orbit` (object): Its orbit
- `orbit_class` (text): Orbit class, e.g. Amor or Main-belt Asteroid
- `orbit_class_code` (text): Orbit class code, e.g. AMO or MBA
- `physical` (object): Its main physical properties, where measured
- `physical_parameters` (list): Every physical parameter JPL holds, with its source
- `potential_impacts` (list): Possible Earth impacts Sentry lists for it
- `satellites` (list): Its known moons
- `sbdb_url` (text): The object's page in JPL's Small-Body Database Lookup
- `short_name` (text): Short name, e.g. 433 Eros
- `spk_id` (text): JPL's numeric id for it (SPK-ID)
- `summary` (text): One line describing the result

**Example output**

```json
{
  "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 (`designation`, text, required): 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_v`, text): 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_days`, text): 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_days`, text): 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_window`, text): 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_magnitude` (number): Absolute magnitude H
- `computed` (text): When NHATS computed the trajectories
- `designation` (text): The asteroid's designation
- `diameter_m` (number): Measured diameter, metres, when known
- `max_diameter_m` (number): Largest likely diameter, metres
- `meets_limits` (true/false): False when no round trip meets the limits given
- `min_delta_v_duration_days` (number): Length of that lowest delta-v round trip, days
- `min_delta_v_km_s` (number): Lowest total delta-v of any round trip, km/s
- `min_delta_v_trajectory` (object): The round trip needing the least delta-v
- `min_diameter_m` (number): Smallest likely diameter, metres
- `min_duration_days` (number): Shortest round trip, days
- `min_duration_delta_v_km_s` (number): Delta-v of that shortest round trip, km/s
- `min_duration_trajectory` (object): The shortest round trip
- `name` (text): Its full name
- `next_optical_magnitude` (number): Its brightness (V magnitude) in that window
- `next_optical_window_end` (text): End of that window
- `next_optical_window_start` (text): Start of the next good window to observe it with telescopes
- `next_radar_date_goldstone` (text): Next date Goldstone radar could observe it
- `orbit_condition_code` (number): Orbit uncertainty, 0 (good) to 9 (poor)
- `sbdb_url` (text): The object's page in JPL's Small-Body Database Lookup
- `summary` (text): One line describing the result
- `viable_trajectories` (number): How many round trips meet the limits

**Example output**

```json
{
  "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 (`designation`, text, required): Its number or designation, such as 99942, 2000 SG344 or 1P (a name like Apophis works only in 'Get asteroid or comet').

**Outputs**

- `absolute_magnitude` (number): Absolute magnitude H
- `computed_at` (text): When Sentry last analysed it (Pacific time)
- `designation` (text): The object's designation
- `diameter_km` (number): Estimated diameter, km
- `first_observed` (text): Date of the first observation used
- `impact_energy_megatons` (number): Impact energy in megatons of TNT
- `impact_probability` (number): Chance of any of its possible impacts, 0 to 1
- `impact_velocity_km_s` (number): Speed at atmospheric entry, km/s
- `impacts` (list): Each possible impact
- `last_observed` (text): Date of the last observation used
- `mass_kg` (number): Estimated mass, kg
- `method` (text): Sentry's analysis method, e.g. IOBS
- `name` (text): Its full name
- `observation_arc_days` (number): Days spanned by the observations
- `observations` (number): Number of observations used
- `on_risk_list` (true/false): True while Sentry lists possible impacts for it
- `palermo_scale_cumulative` (number): Palermo scale over all possible impacts
- `palermo_scale_max` (number): Palermo scale of its most threatening impact
- `potential_impacts` (number): How many possible impact dates Sentry found
- `removed` (true/false): True when it was on the list and later removed
- `removed_at` (text): When it was removed (UTC), if it was
- `sbdb_url` (text): The object's page in JPL's Small-Body Database Lookup
- `summary` (text): One line describing the result
- `torino_scale_max` (number): Highest Torino scale rating, 0 to 10
- `velocity_infinity_km_s` (number): Speed relative to Earth ignoring its gravity, km/s

**Example output**

```json
{
  "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_designation`, text, required): Its temporary name, such as P22rrse, from 'List newly discovered objects'.

**Outputs**

- `absolute_magnitude` (number): Absolute magnitude H (rough)
- `arc_hours` (number): Hours between the first and last observation
- `close_approach_ld` (number): Closest approach to Earth, lunar distances (rough)
- `comet_score` (number): Chance of a comet-like orbit, 0-100
- `declination` (text): Current declination, degrees
- `earth_moid_au` (number): Closest distance between its orbit and Earth's, au (rough)
- `ephemeris_time` (text): Time the position fields refer to (UTC)
- `fit_rms` (number): How well the orbit fits the observations (normalised RMS)
- `geocentric_score` (number): Chance it orbits Earth (often space debris), 0-100
- `impact_rating` (number): Scout's impact rating, 0 (negligible) to 4 (elevated)
- `impact_rating_label` (text): The rating in words: negligible, small, modest, moderate or elevated
- `interior_earth_score` (number): Chance its orbit lies inside Earth's, 0-100
- `last_run` (text): When Scout last analysed it (UTC)
- `magnitude` (number): Current brightness (V magnitude)
- `motion_arcsec_per_min` (number): How fast it moves across the sky, arcseconds per minute
- `neo_1km_score` (number): Chance it is a near-Earth object over 1 km, 0-100
- `neo_score` (number): Chance it is a near-Earth object, 0-100
- `observations` (number): Observations so far
- `pha_score` (number): Chance it is a potentially hazardous asteroid, 0-100
- `right_ascension` (text): Current right ascension, hh:mm
- `solar_elongation_deg` (number): Angle from the Sun in the sky, degrees
- `summary` (text): One line describing the result
- `temporary_designation` (text): Its temporary name on the confirmation page, e.g. P22rrse
- `uncertainty_arcmin` (number): Current position uncertainty (1-sigma), arcminutes
- `uncertainty_tomorrow_arcmin` (number): Position uncertainty a day from now, arcminutes
- `velocity_infinity_km_s` (number): Speed relative to Earth, km/s

**Example output**

```json
{
  "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 (`target`, text, required): 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 (`center`, text): 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 (`start`, date and time): The first moment (UTC). Leave 'Until' blank for this one moment. Blank means now.
- Until (`stop`, date and time): The last moment (UTC), for a table over a span of time.
- Every (`step_size`, number): The gap between rows, with 'Step unit'. Defaults to 1. At most 500 rows. From 1 to 100000.
- Step unit (`step_unit`, text): Minutes, hours or days. Defaults to days. One of: `m` (Minutes), `h` (Hours), `d` (Days).
- Units (`units`, text): 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_plane`, text): 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**

- `center` (text): The center, e.g. Sun
- `count` (number): How many are in this result
- `distance_unit` (text): au or km
- `speed_unit` (text): au/day or km/s
- `summary` (text): One line describing the result
- `target` (text): The body, as Horizons names it
- `target_id` (text): The body's Horizons id
- `vectors` (list): One row per moment (TDB)

**Example output**

```json
{
  "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 (`target`, text, required): 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 (`start`, date and time): The first moment (UTC). Leave 'Until' blank for this one moment. Blank means now.
- Until (`stop`, date and time): The last moment (UTC), for a table over a span of time.
- Every (`step_size`, number): The gap between rows, with 'Step unit'. Defaults to 1. At most 500 rows. From 1 to 100000.
- Step unit (`step_unit`, text): Minutes, hours or days. Defaults to days. One of: `m` (Minutes), `h` (Hours), `d` (Days).
- Latitude (`latitude`, number): Your latitude, -90 to 90. Leave blank to see from Earth's center. From -90 to 90.
- Longitude (`longitude`, number): Your longitude, -180 to 180 (east is positive). From -180 to 180.
- Elevation (m) (`elevation_m`, number): Your height above sea level in metres. From -500 to 10000.

**Outputs**

- `count` (number): How many are in this result
- `observer` (text): Where it is seen from
- `positions` (list): One row per moment
- `summary` (text): One line describing the result
- `target` (text): The body, as Horizons names it
- `target_id` (text): The body's Horizons id

**Example output**

```json
{
  "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 (`designation`, text): Only the moons of this one, such as 22 (Kalliope) or 65803 (Didymos).
- Object type (`object_type`, text): Only moons of asteroids, numbered or unnumbered asteroids, or comets. One of: `a` (Asteroids), `an` (Numbered asteroids), `au` (Unnumbered asteroids), `c` (Comets).
- Confirmed (`confirmed`, text): Only confirmed or only unconfirmed moons. Leave blank with one asteroid. One of: `Y` (Confirmed only), `N` (Unconfirmed only).
- Maximum results (`limit`, number): How many to return, 1 to 1000. From 1 to 1000.

**Outputs**

- `count` (number): How many are in this result
- `moons` (list): The moons
- `summary` (text): One line describing the result
- `total` (number): How many match in all, before the limit

**Example output**

```json
{
  "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_date`, date): The first day to include. Defaults to today.
- Until (`to_date`, date): The last day to include. Defaults to 60 days after 'From'.
- Closer than (lunar distances) (`max_distance_ld`, number): 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 (`body`, text): 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 (`group`, text): 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 (`designation`, text): A number or designation, such as 99942 or 2000 SG344.
- Brightest magnitude (H) (`max_absolute_magnitude`, number): 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 (`sort`, text): Defaults to soonest first. One of: `date` (Soonest first), `-date` (Latest first), `dist` (Closest first), `h` (Largest first), `-v-rel` (Fastest first).
- Maximum results (`limit`, number): How many to return, 1 to 1000. From 1 to 1000.

**Outputs**

- `close_approaches` (list): The close approaches
- `count` (number): How many are in this result
- `summary` (text): One line describing the result
- `total` (number): How many match in all, before the limit

**Example output**

```json
{
  "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_date`, date): Only fireballs on or after this day.
- Until (`to_date`, date): Only fireballs on or before this day.
- At least (kilotons) (`min_impact_energy_kt`, number): Only fireballs with at least this impact energy, in kilotons of TNT. At least 0.
- Only with a location (`require_location`, true/false): Skip fireballs reported without a latitude and longitude.
- Only with an altitude (`require_altitude`, true/false): Skip fireballs reported without a height.
- Order (`sort`, text): 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 (`limit`, number): How many to return, 1 to 1000. Defaults to 20. From 1 to 1000.

**Outputs**

- `count` (number): How many are in this result
- `fireballs` (list): The fireballs
- `summary` (text): One line describing the result

**Example output**

```json
{
  "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_v`, text): 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_days`, text): 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_days`, text): 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_window`, text): 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_magnitude`, text): 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_code`, text): 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 (`sort`, text): 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 (`limit`, number): How many to return, 1 to 5000. Defaults to 50. From 1 to 5000.

**Outputs**

- `asteroids` (list): The accessible asteroids
- `count` (number): How many are in this result
- `summary` (text): One line describing the result
- `total` (number): How many match in all, before the limit

**Example output**

```json
{
  "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_scale`, number): 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_probability`, number): 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_magnitude`, number): Only objects with H at most this; lower H is bigger. From -10 to 100.
- Observed in the last (days) (`observed_within_days`, number): Only objects observed in the last this many days (more than 6). A negative number means not observed for that long.
- Order (`sort`, text): 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 (`limit`, number): How many to return, 1 to 5000. Defaults to 50. From 1 to 5000.

**Outputs**

- `count` (number): How many are in this result
- `objects` (list): The objects on the risk list
- `summary` (text): One line describing the result
- `total` (number): How many match in all, before the limit

**Example output**

```json
{
  "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_score`, number): Only objects at least this likely (0-100) to be near-Earth objects. From 0 to 100.
- Order (`sort`, text): 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 (`limit`, number): How many to return, 1 to 500. Defaults to 100. From 1 to 500.

**Outputs**

- `count` (number): How many are in this result
- `objects` (list): The new objects
- `summary` (text): One line describing the result
- `total` (number): How many match in all, before the limit

**Example output**

```json
{
  "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 (`since`, date): Only objects removed on or after this day.
- Maximum results (`limit`, number): How many to return, 1 to 5000. Defaults to 50. From 1 to 5000.

**Outputs**

- `count` (number): How many are in this result
- `objects` (list): The removed objects
- `summary` (text): One line describing the result
- `total` (number): How many match in all, before the limit

**Example output**

```json
{
  "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 (`designation`, text): A number or designation, such as 433 or 2004 VB.
- Object type (`object_type`, text): Only asteroids, numbered or unnumbered asteroids, or comets. One of: `a` (Asteroids), `an` (Numbered asteroids), `au` (Unnumbered asteroids), `c` (Comets).
- Measurement (`measurement_type`, text): Only delay (distance) or only Doppler (speed) measurements. One of: `R` (Delay (distance)), `P` (Doppler (speed)).
- Maximum results (`limit`, number): How many to return, 1 to 5000. Defaults to 100. From 1 to 5000.

**Outputs**

- `count` (number): How many are in this result
- `observations` (list): The measurements, newest first
- `summary` (text): One line describing the result
- `total` (number): How many match in all, before the limit

**Example output**

```json
{
  "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_year`, number): Defaults to this year. From 1950 to 2100.
- Last launch year (`last_launch_year`, number): Defaults to four years after the first. At most 21 years in all. From 1950 to 2100.
- Best means (`criterion`, text): 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 (`group`, text): Only near-Earth objects, or only potentially hazardous asteroids. One of: `neo` (Near-Earth objects), `pha` (Potentially hazardous asteroids).
- Orbit classes (`orbit_classes`, list): 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 (`limit`, number): How many to return, 1 to 1000. Defaults to 50. From 1 to 1000.

**Outputs**

- `count` (number): How many are in this result
- `launch_years` (text): The launch years searched, e.g. 2027-2029
- `summary` (text): One line describing the result
- `targets` (list): The targets, best first

**Example output**

```json
{
  "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 (`system`, text, required): 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 (`family`, text, required): 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_point`, text): Required for halo, Lyapunov, vertical, axial, long- and short-period orbits. One of: `1` (L1), `2` (L2), `3` (L3), `4` (L4), `5` (L5).
- Branch (`branch`, text): 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_days`, number): Only orbits with at least this period. At least 0.
- Longest period (days) (`max_period_days`, number): Only orbits with at most this period. At least 0.
- Stable only (`stable_only`, true/false): Only stable orbits (stability index 1 or less).
- Maximum results (`limit`, number): How many to return, 1 to 1000. Defaults to 20. From 1 to 1000.

**Outputs**

- `branch` (text): The branch, if any
- `count` (number): How many are in this result
- `family` (text): The orbit family
- `length_unit_km` (number): The normalised length unit in km (the distance between the bodies)
- `libration_point` (text): The libration point, if any
- `mass_ratio` (number): Mass of the smaller body over the total
- `orbits` (list): The orbits
- `summary` (text): One line describing the result
- `system` (text): The system, e.g. Earth-Moon
- `time_unit_seconds` (number): The normalised time unit in seconds
- `total` (number): How many match in all, before the limit

**Example output**

```json
{
  "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 (`fields`, list): 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_type`, text): Asteroids or comets. Leave blank for both. One of: `a` (Asteroids), `c` (Comets).
- Numbered (`numbered`, text): Only numbered (well-observed) or only unnumbered objects. One of: `n` (Numbered only), `u` (Unnumbered only).
- Group (`group`, text): Only near-Earth objects, or only potentially hazardous asteroids. One of: `neo` (Near-Earth objects), `pha` (Potentially hazardous asteroids).
- Orbit classes (`orbit_classes`, list): 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_satellites`, true/false): Only objects with at least one known moon.
- Leave out comet fragments (`exclude_fragments`, true/false): Skip fragments of broken-up comets.
- Constraints (`constraints`, text): 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 (`sort`, text): Up to three field names, with - for descending, e.g. -diameter or H.
- Maximum results (`limit`, number): How many to return, 1 to 1000. Defaults to 50. From 1 to 1000.
- Skip (`offset`, number): How many matches to skip, to page through a long list. At least 0.

**Outputs**

- `bodies` (list): The matching objects, keyed by the fields asked for (the default fields shown)
- `count` (number): How many are in this result
- `fields` (list): The fields each object carries
- `summary` (text): One line describing the result
- `total` (number): How many match in all, before the limit

**Example output**

```json
{
  "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
}
```
