SSD API

https://ssd-api.jpl.nasa.gov/doc/
Admin
The SSD API provides programmatic interfaces to various astronomical data and services from JPL's...
Tokens:63,739
Snippets:430
Trust Score:10
Update:2 months ago
Show doc for...
Tokens:
Raw
### JSON-format Output Examples

Source: https://ssd-api.jpl.nasa.gov/doc/horizons_lookup.html

Examples of JSON responses for singular matches, multiple matches, and no matching objects.

```json
{
  "signature" : {
    "source" : "NASA/JPL Horizons Lookup API",
    "version" : "1.0"
  },
  "count" : 1,
  "result" : [
    {
      "alias" : [ "3264226", "K04M04N" ],
      "name" : "99942 Apophis",
      "spkid" : "2099942",
      "pdes" : "2004 MN4",
      "type" : "asteroid (integrated barycenter)",
    }
  ]
}
```

```json
{
  "signature" : {
    "source" : "NASA/JPL Horizons Lookup API",
    "version" : "1.0"
  },
  "count" : 3,
  "result" : [
    {
      "name" : "Juno (spacecraft)",
      "pdes" : null,
      "spkid" : "-61",
      "type" : "spacecraft",
      "alias" : []
    },
    {
      "name" : "Juno Centaur Stage (spacecraft)",
      "pdes" : null,
      "spkid" : "-610",
      "type" : "spacecraft",
      "alias" : []
    },
    {
      "name" : "3 Juno",
      "pdes" : "A804 RA",
      "spkid" : "20000003",  
      "type" : "asteroid (integrated barycenter)",
      "alias" : [ "I04R00A" ]
    }
  ]
}
```

```json
{
  "signature" : {
    "source" : "NASA/JPL Horizons Lookup API",
    "version" : "1.0"
  },
  "count" : "0"
}
```

--------------------------------

### Text-format Output Examples

Source: https://ssd-api.jpl.nasa.gov/doc/horizons_lookup.html

Examples of plain-text responses for singular matches, multiple matches, and no matching objects. Records are delimited by a trailing blank line.

```text
API VERSION: 1.0
API SOURCE: NASA/JPL Horizons Lookup API

Object name        = 99942 Apophis
Type               = asteroid (integrated barycenter)
Primary SPKID      = 20099942
Primary designation= 2004 MN4
Aliases            = 3264226, 2099942, K04M04N



```

```text
API VERSION: 1.0
API SOURCE: NASA/JPL Horizons Lookup API

Object name        = Patroclus (system barycenter)
Type               = asteroid barycenter
Primary SPKID      = 20000617
Primary designation= 
Aliases            = 

Object name        = Patroclus (primary body)
Type               = asteroidal system primary
Primary SPKID      = 920000617
Primary designation= 
Aliases            = 

Object name        = Menoetius
Type               = asteroidal system satellite
Primary SPKID      = 120000617
Primary designation= Patroclus I
Aliases            = 

Object name        = 617 Patroclus
Type               = asteroid (integrated barycenter)
Primary SPKID      = 20000617
Primary designation= A906 UL
Aliases            = 1962 NB, 1941 XC, 2000617, J06U00L



```

```text
API VERSION: 1.0
API SOURCE: NASA/JPL Horizons Lookup API

NOTICE: no matches found


```

--------------------------------

### Horizons API Text Output Example

Source: https://ssd-api.jpl.nasa.gov/doc/horizons_file.html

Example of a raw text response from the Horizons system, showing header information and the ephemeris data block.

```text
API VERSION: 0.2
API SOURCE: NASA/JPL Horizons API

*******************************************************************************
Ephemeris / WWW_USER Thu May 14 07:39:14 2020 Pasadena, USA      / Horizons    
*******************************************************************************
Target body name: Mars (499)                      {source: mar097}
Center body name: Earth (399)                     {source: mar097}
Center-site name: GEOCENTRIC
*******************************************************************************
Start time      : A.D. 1998-Jan-01 10:00:00.0000 UT      
Stop  time      : A.D. 1998-Jan-02 00:00:00.0000 UT      
Step-size       : 60 minutes
*******************************************************************************
Target pole/equ : IAU_MARS                        {West-longitude positive}
Target radii    : 3396.2 x 3396.2 x 3376.2 km     {Equator, meridian, pole}    
Center geodetic : 0.00000000,0.00000000,0.0000000 {E-lon(deg),Lat(deg),Alt(km)}
Center cylindric: 0.00000000,0.00000000,0.0000000 {E-lon(deg),Dxy(km),Dz(km)}
Center pole/equ : High-precision EOP model        {East-longitude positive}
Center radii    : 6378.1 x 6378.1 x 6356.8 km     {Equator, meridian, pole}    
Target primary  : Sun
Vis. interferer : MOON (R_eq= 1737.400) km        {source: mar097}
Rel. light bend : Sun, EARTH                      {source: mar097}
Rel. lght bnd GM: 1.3271E+11, 3.9860E+05 km^3/s^2                              
Atmos refraction: NO (AIRLESS)
RA format       : HMS
Time format     : CAL
EOP file        : eop.200513.p200804                                           
EOP coverage    : DATA-BASED 1962-JAN-20 TO 2020-MAY-13. PREDICTS-> 2020-AUG-03
Units conversion: 1 au= 149597870.700 km, c= 299792.458 km/s, 1 day= 86400.0 s
Table cut-offs 1: Elevation (-90.0deg=NO ),Airmass (>38.000=NO), Daylight (NO )
Table cut-offs 2: Solar elongation (  0.0,180.0=NO ),Local Hour Angle( 0.0=NO )
Table cut-offs 3: RA/DEC angular rate (     0.0=NO )                           
*****************************************************************************************
 Date__(UT)__HR:MN     R.A._____(ICRF)_____DEC  APmag  S-brt            delta      deldot
*****************************************************************************************
$$SOE
 1998-Jan-01 10:00     20 55 41.20 -18 33 23.0   1.17   4.08 2.13799045474771   5.6049390
 1998-Jan-01 11:00     20 55 49.17 -18 32 49.7   1.17   4.08 2.13812533287512   5.6044117
 1998-Jan-01 12:00     20 55 57.13 -18 32 16.5   1.17   4.08 2.13826019831403   5.6038846
 1998-Jan-01 13:00     20 56 05.09 -18 31 43.1   1.17   4.08 2.13839505107206   5.6033579
 1998-Jan-01 14:00     20 56 13.05 -18 31 09.8   1.17   4.08 2.13852989115697   5.6028315
 1998-Jan-01 15:00     20 56 21.01 -18 30 36.5   1.17   4.08 2.13866471857652   5.6023055
 1998-Jan-01 16:00     20 56 28.97 -18 30 03.1   1.17   4.08 2.13879953333835   5.6017797
 1998-Jan-01 17:00     20 56 36.93 -18 29 29.7   1.17   4.08 2.13893433545018   5.6012543
 1998-Jan-01 18:00     20 56 44.89 -18 28 56.3   1.17   4.08 2.13906912492008   5.6007292
 1998-Jan-01 19:00     20 56 52.85 -18 28 22.9   1.17   4.08 2.13920390175678   5.6002045
 1998-Jan-01 20:00     20 57 00.81 -18 27 49.4   1.17   4.08 2.13933866596968   5.5996802
 1998-Jan-01 21:00     20 57 08.76 -18 27 15.9   1.17   4.08 2.13947341756857   5.5991564
 1998-Jan-01 22:00     20 57 16.72 -18 26 42.5   1.17   4.08 2.13960815656331   5.5986329
 1998-Jan-01 23:00     20 57 24.67 -18 26 08.9   1.17   4.08 2.13974288296371   5.5981098
 1998-Jan-02 00:00     20 57 32.63 -18 25 35.4   1.17   4.08 2.13987759677950   5.5975872
$$EOE
*****************************************************************************************
Column meaning:

... [some content excluded here for brevity] ...

 Computations by ...
     Solar System Dynamics Group, Horizons On-Line Ephemeris System
     4800 Oak Grove Drive, Jet Propulsion Laboratory
     Pasadena, CA  91109   USA
     Information: http://ssd.jpl.nasa.gov/
     Connect    : telnet://ssd.jpl.nasa.gov:6775  (via browser)
                  telnet ssd.jpl.nasa.gov 6775    (via command-line)
     Author     : Jon.D.Giorgini@jpl.nasa.gov

*****************************************************************************************
```

--------------------------------

### API Response Example

Source: https://ssd-api.jpl.nasa.gov/doc/periodic_orbits.html

Example JSON response from the periodic orbits API for an Earth-Moon halo orbit query.

```json
{
  "signature" : {"source" : "NASA/JPL Three-Body Periodic Orbits API","version" : "1.0"},
  "system" : {
    "name" : "Earth-Moon",
    "mass_ratio" : "1.215058560962404e-02",
    "radius_secondary" : "1737.1",
    "L1" : ["0.8369151257723572","0.0","0.0"],
    "L2" : ["1.155682165444884","0.0","0.0"]
    "L3" : ["-1.005062645810278","0.0","0.0"],
    "L4" : ["0.4878494143903759","0.8660254037844386","0.0"],
    "L5" : ["0.4878494143903759","-0.8660254037844386","0.0"],
    "lunit" : "389703.2648292776",
    "tunit" : "382981.2891290545"
  },
  "family" : "halo",
  "libration_point" : "1",
  "branch" : "N",
  "limits" : {
    "jacobi" : ["0.19516273085815472","3.1743435193301153"],
    "period" : [" 1.8036720655626510E+00"," 3.1233143922761588E+00"],
    "stability" : ["1","1180.4065333857613"]
  },
  "count" : "5731",
  "fields" : ["x","y","z","vx","vy","vz","jacobi","period","stability"],
  "data" : [
    ["-4.1456184803140111E-01","0.0000000000000000E+00","9.0753120433295065E-01","-1.1555581216266303E-12","1.4076145460136695E+00","3.9979936124406781E-13","1.9516273085815472E-01","3.1233143922761588E+00","2.4340572681337468E+02"],
    ["-4.1421982661362478E-01","0.0000000000000000E+00","9.0768629637651521E-01","-1.1474877439509793E-12","1.4072700950580586E+00","3.9684610255625016E-13","1.9584418854987273E-01","3.1233112610554632E+00","2.4352872940755927E+02"],
    ["-4.1387776145545296E-01","0.0000000000000000E+00","9.0784124892510798E-01","-1.2473183104559711E-12","1.4069256037546980E+00","4.3182616480665382E-13","1.9652572760226936E-01","3.1233081181627282E+00","2.4365166172846071E+02"],
    ...
  ]
}
```

--------------------------------

### Mode A JSON Payload Example

Source: https://ssd-api.jpl.nasa.gov/doc/mdesign.html

Example of the JSON payload structure for Mode A, including signature, fields, constraints, and records.

```json
{
  "signature" : {"version":"1.1","source":"NASA/JPL Small-Body Mission Design API"},
  "fields": ["name","date0","MJD0","datef","MJDF","c3_dep","vinf_dep","vinf_arr","dv_tot","tof","class","H","condition_code","neo","pha","bin","pdes"],
  "constraints": {"lim":200,"year":"2025,2026,2027,2028,2029","crit":1}
  "records": [
    ["52768 (1998 OR2)","2026-09-11",61294,"2031-04-28",62984,0.00258064,0.0508,8.4057,8.4565,1690,"AMO",15.8,0,"Y","Y","","52768"],
    ["137108 (1999 AN10)","2027-04-19",61514,"2027-08-07",61624,0.00868624,0.0932,26.3335,26.4267,110,"APO",17.9,0,"Y","Y","","137108"],
    ["451124 (2009 KC3)","2027-12-15",61754,"2032-08-20",63464,0.01334025,0.1155,12.3224,12.4379,1710,"APO",18.0,1,"Y","Y","","451124"],
    ...
  ]
}
```

--------------------------------

### FIELD_INFO_RECORD Structure

Source: https://ssd-api.jpl.nasa.gov/doc/sbdb_filter.html

Example of an individual field information record.

```json
{
   "name" : "IR",
   "title" : "I-R",
   "description" : "color index I-R",
   "units" : "mag",
   "is_numeric" : "Y",
   "is_constraint" : "Y",
   "align_comp" : null,
   "align_full" : "C"
}
```

--------------------------------

### GET /

Source: https://ssd-api.jpl.nasa.gov/doc/horizons_file.html

Queries the Horizons system using an input file content and specifies the desired output format.

```APIDOC
## GET /

### Description
Queries the Horizons system using provided input file content and returns the result in the specified format.

### Method
GET

### Endpoint
/

### Parameters
#### Query Parameters
- **input** (string) - Required - Horizons input file content, encoded as appropriate
- **format** (string) - Optional - Output format: `json` (default) or `text`

### Response
#### Success Response (200)
- **signature** (object) - Contains the API version and source information. Always check this object to ensure compatibility.
```

--------------------------------

### Define Horizons Input File

Source: https://ssd-api.jpl.nasa.gov/doc/horizons_file.html

Example configuration file content for requesting an observer ephemeris of Mars.

```text
!$$SOF
COMMAND='499'
OBJ_DATA='YES'
MAKE_EPHEM='YES'
TABLE_TYPE='OBSERVER'
CENTER='500@399'
START_TIME='2006-01-01'
STOP_TIME='2006-01-20'
STEP_SIZE='1 d'
QUANTITIES='1,9,20,23,24,29'
```

--------------------------------

### Retrieve empty result set

Source: https://ssd-api.jpl.nasa.gov/doc/fireball.html

Example of a response when no records match the specified constraints.

```json
{ "count":0, "signature":{"version":"1.2","source":"NASA/JPL Fireball Data API"} }
```

--------------------------------

### SBDB Class Definitions Structure

Source: https://ssd-api.jpl.nasa.gov/doc/sbdb_filter.html

Example of the class definition container structure within sb_defs.

```json
"class" : [
  { "code" : "AMO",
    "kind" : "A",
    "title" : "Amor",
    "description" : "Near-Earth asteroid orbits similar to that of 1221 Amor (1.017 au < q < 1.3 au)."
  },
  { "code" : "PAR",
    "kind" : "C",
    "title" : "Parabolic Comet",
    "description" : "Comets on parabolic orbits (e = 1.0)."
  },
  ...
]
```

--------------------------------

### Search for non-unique objects

Source: https://ssd-api.jpl.nasa.gov/doc/horizons.html

Example output format when a COMMAND query returns multiple matching small-body records.

```text
API VERSION: 1.0
API SOURCE: NASA/JPL Horizons API

*******************************************************************************
JPL/DASTCOM            Small-body Index Search Results     2021-May-11 07:53:26

 Comet AND asteroid index search:

    DES = 141P;

 Matching small-bodies:

    Record #  Epoch-yr  >MATCH DESIG<  Primary Desig  Name
    --------  --------  -------------  -------------  -------------------------
    90001032    2011    141P           141P            Machholz 2
    90001033    2019    141P           141P            Machholz 2
    90001034    1994    141P-A         141P-A          Machholz 2
    90001035    1997    141P-A         141P-A          Machholz 2
    90001036    1999    141P-A         141P-A          Machholz 2
    90001037    1994    141P-D         141P-D          Machholz 2
    90001038    1999    141P-D         141P-D          Machholz 2

 (7 matches. To SELECT, enter record # (integer), followed by semi-colon.)
*******************************************************************************
```

--------------------------------

### Example JSON-format API response

Source: https://ssd-api.jpl.nasa.gov/doc/horizons.html

A sample successful JSON response containing a signature and the primary result field.

```json
{
  "signature" : {
    "source" : "NASA/JPL Horizons API",
    "version" : "1.0"
  },
  "result" : " \n \n*******************************************************************************\nEphemeris / WWW_USER Tue Sep  6 22:51:14 2022 Pasadena, USA      / Horizons    \n*******************************************************************************\nTarget body name: Mars (499)                      {source: mar097}\nCenter body name: Earth (399)                     {source: mar097}\nCenter-site name: GEOCENTRIC\n*******************************************************************************\nStart time      : A.D. 1998-Jan-01 10:00:00.0000 UT      \nStop  time      : A.D. 1998-Jan-02 00:00:00.0000 UT      \nStep-size       : 60 minutes\n*******************************************************************************\nTarget pole/equ : IAU_MARS                        {West-longitude positive}\nTarget radii    : 3396.19, 3396.19, 3376.2 km     {Equator_a, b, pole_c}\nCenter geodetic : 0.0, 0.0, -6378.137             {E-lon(deg),Lat(deg),Alt(km)}\nCenter cylindric: 0.0, 0.0, 0.0                   {E-lon(deg),Dxy(km),Dz(km)}\nCenter pole/equ : High-precision EOP model        {East-longitude positive}\nCenter radii    : 6378.137, 6378.137, 6356.752 km {Equator_a, b, pole_c}\nTarget primary  : Sun\nVis. interferer : MOON (R_eq= 1737.400) km        {source: mar097}\nRel. light bend : Sun, EARTH                      {source: mar097}\nRel. lght bnd GM: 1.3271E+11, 3.9860E+05 km^3/s^2                              \nAtmos refraction: NO (AIRLESS)\nRA format       : HMS\nTime format     : CAL \nCalendar mode   : Mixed Julian/Gregorian\nEOP file        : eop.200513.p200804                                           \nEOP coverage    : DATA-BASED 1962-JAN-20 TO 2020-MAY-13. "
```

--------------------------------

### Request Observer Ephemeris via HTTP GET

Source: https://ssd-api.jpl.nasa.gov/doc/horizons.html

Example of a GET request to retrieve Mars ephemeris data in plain-text format.

```http
https://ssd.jpl.nasa.gov/api/horizons.api?format=text&COMMAND='499'&OBJ_DATA='YES'&MAKE_EPHEM='YES'&EPHEM_TYPE='OBSERVER'&CENTER='500@399'&START_TIME='2006-01-01'&STOP_TIME='2006-01-20'&STEP_SIZE='1%20d'&QUANTITIES='1,9,20,23,24,29'
```

--------------------------------

### Mode T JSON Payload Example

Source: https://ssd-api.jpl.nasa.gov/doc/mdesign.html

Example of the JSON response structure returned when using Mode T.

```json
{
  "signature" : {"source" : "NASA/JPL Small-Body Mission Design API", "version" : "1.1"},
  "md_constraints" : {
    "ec" : "0.2056408220896557",
    "in" : "7.003733902930839",
    "jd0" : "2458849.5",
    "jdf" : "2459132.5",
    "maxdist" : "0.10",
    "maxout" : "100",
    "om" : "48.30597718083336",
    "qr" : "0.3074958016246215",
    "tp" : "2459067.6508400026",
    "w" : "29.18348714438387"
  },
  "count" : "87",
  "fields" : ["full_name","date","jd","min_dist_au","min_dist_km","rel_vel","class","H","condition_code","neo","pha","sats","spkid","pdes"],
  "data" : [
      ["       (2019 XQ)","2020-04-10",58949,"4.404063349100577E-03",658838.499453357,"1.165877291970840E-02","ATE","23.8","7","Y","N","0","3893862","2019 XQ"],
      ["       (2017 WR)","2020-06-02",59002,"8.116836162667585E-03",1214261.40675583,"9.998399964863399E-03","ATE","24.8","6","Y","N","0","3789455","2017 WR"
      ...
    ]
}
```

--------------------------------

### Execute Horizons Request via curl

Source: https://ssd-api.jpl.nasa.gov/doc/horizons_file.html

Command-line interface example to send the input file and save the response.

```bash
curl -s -F format=text -F input=@my_input_file.txt https://ssd.jpl.nasa.gov/api/horizons_file.api > results.txt
```

--------------------------------

### Sample Data Output

Source: https://ssd-api.jpl.nasa.gov/doc/sb_radar.html

A full example of the API response containing signature, count, field definitions, and data records.

```json
{
  "signature" : {"source" : "NASA/JPL Small-Body Radar Astrometry API", "version" : "1.0"},
  "count" : "3",
  "fields" : [ "des","epoch","value","sigma","units","freq","rcvr","xmit","bp" ],
  "data" : [
    [
      "1997 WQ23",
      "2013-11-22 01:53:00",
      "111982347.7",
      "1.000",
      "us",
      "2380",
      "-1",
      "-1",
      "C"
    ],
    [
      "1997 WQ23",
      "2013-11-19 00:38:00",
      "96148022.94",
      "4.000",
      "us",
      "2380",
      "-1",
      "-1",
      "C"
    ],
    [
      "1997 WQ23",
      "2013-11-19 00:25:00",
      "-124458.2215",
      "0.300",
      "Hz",
      "2380",
      "-1",
      "-1",
      "C"
    ]
  ]
}
```

--------------------------------

### Sample Data Output for Mode S

Source: https://ssd-api.jpl.nasa.gov/doc/scout.html

Example JSON response structure for Mode S, containing a signature and a list of object records.

```json
{
  "signature":{"version":"1.2","source":"NASA/JPL Scout API"},
  "count":"3","data":[
  {
    "objectName":"XGB1CE8",
    "lastRun":"2016-04-25 20:05:00","uncP1":"0.1","neoScore":"100","rating":"0",
    "rate":"0.3","unc":"0.1","phaScore":"0","ra":"12:29","elong":"147",
    "nObs":"18","arc":"25.47","tisserandScore":"0","caDist":"0.13",
    "vInf":"22.1","H":"29.2","rmsN":"1.06","ieoScore":"0","dec":"-11",
    "geocentricScore":"0","moid":"0.0003","Vmag":"29.2
  },
  {
    "objectName":"XFAC29D",
    "lastRun":"2016-04-25 20:05:00","uncP1":"0.6","neoScore":"100","rating":"0",
    "rate":"0.8","unc":"0.6","phaScore":"0","ra":"01:25","elong":"20",
    "nObs":"15","arc":"8.63","tisserandScore":"0","caDist":"1.59",
    "vInf":"21.0","H":"28.2","rmsN":"0.55","ieoScore":"0","dec":"+11",
    "geocentricScore":"0","moid":"0.0020","Vmag":"32.5"
  },
  {
    "objectName":"P10v2Pz",
    "lastRun":"2016-04-30 15:02:00","uncP1":"667.5","neoScore":"100","rating":"0",
    "rate":"39.2","unc":"382.5","phaScore":"0","ra":"16:59","elong":"139",
    "nObs":"4","arc":"0.91","tisserandScore":"65","caDist":"11.30",
    "vInf":"14.9","H":"26.593450","rmsN":"0.60","ieoScore":"0","dec":"+08",
    "geocentricScore":"0","moid":"0.0235","Vmag":"20.7"
  }
]}
```

--------------------------------

### Extract SPK Data via Command Line

Source: https://ssd-api.jpl.nasa.gov/doc/horizons_file.html

Example command to extract binary SPK content from text-format API responses.

```bash
curl -s -F format=text -F input=@my_input_file.txt https://ssd.jpl.nasa.gov/api/horizons_file.api | awk '/REFGL1NQ/,0' | base64 --decode > object.bsp

```

--------------------------------

### Zero-Count Query Response

Source: https://ssd-api.jpl.nasa.gov/doc/cad.html

Example of an API response when a query returns no results.

```json
{
  "signature":{"version":"1.5","source":"NASA/JPL SBDB Close Approach Data API"},
  "count" : 0
}
```

--------------------------------

### GET /jd_cal.api

Source: https://ssd-api.jpl.nasa.gov/doc/jd_cal.html

Converts between Julian Day numbers and calendar date/time strings.

```APIDOC
## GET /jd_cal.api

### Description
Converts a Julian Day number to a calendar date/time or a calendar date/time to a Julian Day number.

### Method
GET

### Endpoint
https://ssd-api.jpl.nasa.gov/jd_cal.api

### Parameters
#### Query Parameters
- **jd** (number) - Optional - Julian date to convert (UT). Range: [-1931076.5 : 38245308.5]
- **cd** (string) - Optional - Calendar date/time to convert. Format: YYYY-MM-DD or YYYY-MM-DD_hh:mm:ss
- **format** (string) - Optional - Format the resulting JD or date/time. Default: jd.7
```

--------------------------------

### File List Output

Source: https://ssd-api.jpl.nasa.gov/doc/scout.html

Sample output for a file list request in mode O, showing available files and their sizes.

```json
"file": {
  "mpc":{"size":486,"name":"Observation File (MPC-format)"},
}
```

--------------------------------

### Example JSON Signature Object

Source: https://ssd-api.jpl.nasa.gov/doc/nhats.html

The signature object contains the API version and source information. Always verify the version matches the current documentation.

```json
"signature":{"version":"1.0","source":"NASA/JPL ... API"}
```

--------------------------------

### GET https://ssd.jpl.nasa.gov/api/horizons.api

Source: https://ssd-api.jpl.nasa.gov/doc/horizons.html

Retrieves ephemeris data based on the provided query parameters.

```APIDOC
## GET https://ssd.jpl.nasa.gov/api/horizons.api

### Description
Retrieves ephemeris data for a specified celestial object. The output format and content are controlled by various query parameters.

### Method
GET

### Endpoint
https://ssd.jpl.nasa.gov/api/horizons.api

### Parameters
#### Query Parameters
- **format** (string) - Optional - Specify output format: 'json' (default) or 'text'.
- **COMMAND** (string) - Required - Target search, selection, or user-input object mode.
- **OBJ_DATA** (string) - Optional - Toggles return of object summary data ('YES' or 'NO', default 'YES').
- **MAKE_EPHEM** (string) - Optional - Toggles generation of ephemeris ('YES' or 'NO', default 'YES').
- **EPHEM_TYPE** (string) - Optional - Selects type of ephemeris: 'OBSERVER', 'VECTORS', 'ELEMENTS', 'SPK', or 'APPROACH'.
- **CENTER** (string) - Optional - Selects coordinate origin (observing site).
- **START_TIME** (string) - Optional - Specifies ephemeris start time.
- **STOP_TIME** (string) - Optional - Specifies ephemeris stop time.
- **STEP_SIZE** (string) - Optional - Ephemeris output print step.
- **QUANTITIES** (string) - Optional - List of desired output quantity option codes.
```

--------------------------------

### GET /sentry.api

Source: https://ssd-api.jpl.nasa.gov/doc/sentry.html

Retrieves Sentry system data based on the specified mode and filters.

```APIDOC
## GET /sentry.api

### Description
Retrieves data from the CNEOS Sentry system. The mode is determined by the provided query parameters: Object-specific (O) if 'des' or 'spk' is provided, Removed-objects (R) if 'removed' is provided, Virtual Impactor (V) if 'all' is provided, and Summary (S) by default.

### Method
GET

### Endpoint
https://ssd-api.jpl.nasa.gov/sentry.api

### Parameters
#### Query Parameters
- **spk** (int) - Optional - Select data for the object matching this SPK-ID (Mode O)
- **des** (string) - Optional - Select data for the object matching this designation (Mode O)
- **h-max** (number) - Optional - Limit data to those with an absolute magnitude H <= value (Modes S, V)
- **ps-min** (integer) - Optional - Limit data to those with a Palermo scale >= value (Modes S, V)
- **ip-min** (number) - Optional - Limit data to those with an impact-probability >= value (Modes S, V)
- **days** (int) - Optional - Filter by number of days since last observation (Modes S, V)
- **all** (boolean) - Optional - Request the complete VI data set (Mode V)
- **removed** (boolean) - Optional - Request the list of removed objects (Mode R)
```

--------------------------------

### GET /api/horizons_lookup.api

Source: https://ssd-api.jpl.nasa.gov/doc/horizons_lookup.html

Queries the Horizons system for objects matching the provided search string.

```APIDOC
## GET /api/horizons_lookup.api

### Description
Queries the Horizons system for objects matching the provided search string. Returns a list of matching objects or a count of zero if no matches are found.

### Method
GET

### Endpoint
https://ssd.jpl.nasa.gov/api/horizons_lookup.api

### Parameters
#### Query Parameters
- **sstr** (string) - Required - The search string to match against object names or designations.
- **format** (string) - Optional - The output format. Supported values are 'json' (default) and 'text'.
```

--------------------------------

### Execute Horizons Request via Python

Source: https://ssd-api.jpl.nasa.gov/doc/horizons_file.html

Python script using the requests library to upload the input file.

```python
import sys
import requests
f = open(sys.argv[1])
url = 'https://ssd.jpl.nasa.gov/api/horizons_file.api'
r = requests.post(url, data={'format':'text'}, files={'input': f})
print(r.text)
f.close()
```

--------------------------------

### SBDB Field Definitions Structure

Source: https://ssd-api.jpl.nasa.gov/doc/sbdb_filter.html

Example of the field definition container structure within sb_defs.

```json
"field" : {
  "object" : {
    "field_label" : "Object Fields",
    "constraint_label" : null,
    "list" : [
      FIELD_INFO_RECORD,
      ...
    ]
  },
  "orbit" : {
    "field_label" : "Orbit and Model Parameter Fields",
    "constraint_label" : "Orbital Parameter",
    "list" : [
      FIELD_INFO_RECORD,
      ...
    ]
  },
  "phys_par" : {
    "field_label" : "Physical Parameter Fields",
    "constraint_label" : "Physical Parameter",
    "list" : [
      FIELD_INFO_RECORD,
      ...
    ]
  }
```

--------------------------------

### Handle NEO-Filtered Multi-Object Matches

Source: https://ssd-api.jpl.nasa.gov/doc/sbdb.html

Example JSON response for a query with neo=2 that returns a list of non-NEO objects including orbital parameters.

```json
{
  "signature":{"version":"1.0","source":"NASA/JPL Small-Body Database (SBDB) API"},
  "info" : "specified object matched one or more non-NEO: see list",
  "count" : 4,
  "list" : [
    {
       "pdes" : "2016 AA30",
       "q" : "2.57",
       "name" : "(2016 AA30)",
       "moid" : "1.57",
       "class" : "MBA"
    },
    {
       "pdes" : "2016 AA33",
       "q" : "1.88",
       "name" : "(2016 AA33)",
       "moid" : "0.887",
       "class" : "MBA"
    },
    {
       "pdes" : "2016 AA35",
       "q" : "2.91",
       "name" : "(2016 AA35)",
       "moid" : "1.93",
       "class" : "MBA"
    },
    {
       "pdes" : "2016 AA36",
       "q" : "2.12",
       "name" : "(2016 AA36)",
       "moid" : "1.13",
       "class" : "MBA"
    }
  ]
}
```

--------------------------------

### Retrieve Satellite Data List

Source: https://ssd-api.jpl.nasa.gov/doc/sb_sat.html

Example of a JSON response containing a list of satellite objects.

```json
{
  "signature" : {"source" : "NASA/JPL Small-Body Satellites API", "version" : "1.0"},
  "count" : "2",
  "data" : [
    {
      "sat" : {
        "class" : "MBA",
        "iau_name" : "Petit-Prince",
        "iau_num" : "1",
        "kind" : "an",
        "notes" : null,
        "pdes" : "45",
        "prefix" : null,
        "prov_num" : "1",
        "prov_year" : "1998",
        "ref" : "Merline et al. (1999), IAUC 7129",
        "sat_fullname" : "(45) Eugenia I Petit-Prince"
      }
    },
    {
      "sat" : {
        "class" : "MBA",
        "iau_name" : null,
        "iau_num" : null,
        "kind" : "an",
        "notes" : null,
        "pdes" : "45",
        "prefix" : null,
        "prov_num" : "1",
        "prov_year" : "2004",
        "ref" : "Marchis et al. (2007), IAUC 8817",
        "sat_fullname" : "S/2004 (45) 1"
      }
    }
  ]
}
```

--------------------------------

### Base-64 Encoded SPK Binary Data

Source: https://ssd-api.jpl.nasa.gov/doc/horizons_file.html

Example of the base-64 encoded binary SPK file output returned by the API.

```text
API VERSION: 0.2
API SOURCE: NASA/JPL Horizons API

SPK Binary Data Follows -- base64 encoded:

REFGL1NQSyACAAAABgAAAFNNQl9TUEtfRklMRSAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
ICAgICAgICAgICAgICAgICAgID4AAAA+AAAAULQAAExUTC1JRUVFAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
...
AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
AAAAAAAAAAAAAAAAAAAAAAAAAA==
```

--------------------------------

### Successful Query Response

Source: https://ssd-api.jpl.nasa.gov/doc/cad.html

Example of a successful API response containing multiple close-approach records.

```json
{
  "signature":{"source" : "NASA/JPL SBDB Close Approach Data API","version" : "1.5"},
  "count":3,
  "fields":["des","orbit_id","jd","cd","dist","dist_min","dist_max","v_rel","v_inf","t_sigma_f","h","diameter","diameter_sigma","fullname"],
  "data":[
    ["153814","174","2461948.724524223","2028-Jun-26 05:23","0.00166253924938707","0.00166237672775144","0.00166270177137481","10.2426019613426","10.084918538826","< 00:01","18.33","0.932","0.011","153814 (2001 WN5)"],
    ["99942","206","2462240.407091595","2029-Apr-13 21:46","0.000254099098170977","0.000254085852623379","0.000254112343772133","7.42249308586014","5.84135545611464","< 00:01","19.7","0.34","0.04"," 99942 Apophis (2004 MN4)"],
    ["2001 AV43","42","2462452.142037054","2029-Nov-11 15:25","0.00209271674918052","0.00209125158265035","0.00209418316351851","3.99789389003422","3.66561381185116","00:03","24.6",null,null,"       (2001 AV43)"]
   ]
}
```

--------------------------------

### Example JSON Payload for Mode Q

Source: https://ssd-api.jpl.nasa.gov/doc/mdesign.html

Sample response structure for a Mode Q API request, including object metadata and mission trajectory data.

```json
{
  "signature" : {"version":"1.1","source":"NASA/JPL Small-Body Mission Design API"},
  "object" : {
    "des" : "1",
    "fullname" : "1 Ceres",
    "spkid" : "2000001",
    "orbit_class" : "MBA",
    "condition_code" : "0",
    "data_arc" : "24437",
    "orbit_id" : "34",
    "md_orbit_id" : "34",
    "computed_on" : "2019-02-13"
  },
  "fields": ["MJD0","MJDf","vinf_dep","vinf_arr","phase_ang","earth_dist","elong_arr","decl_dep","approach_ang"],
  "selectedMissions": [[61745,62125,11.3777,6.3766,52.45,3.8475,4.58,5.98,137.61],
    [62265,62565,11.26,9.9863,26.18,3.9258,12.22,-69.43,116.36],
    [65535,65820,11.177,10.6303,25.75,3.8817,20.29,-69.69,112.90],
    [62580,64015,10.9125,6.7504,58.75,3.9083,15.97,-55.14,135.37],
    [58070,58320,10.8491,9.6527,33.45,3.2371,41.76,69.94,120.41],
    [66465,66705,10.8218,10.6407,29.94,3.1188,48.58,70.36,117.04],
    ...
  ]
}
```

--------------------------------

### SPK File Parameters

Source: https://ssd-api.jpl.nasa.gov/doc/horizons.html

Parameters specific to generating binary SPK files for small bodies.

```APIDOC
## SPK File Parameters

### START_TIME
- **Description**: Specifies ephemeris start time.

### STOP_TIME
- **Description**: Specifies ephemeris stop time.
```

--------------------------------

### GET https://ssd-api.jpl.nasa.gov/sbdb_query.api

Source: https://ssd-api.jpl.nasa.gov/doc/sbdb_query.html

Query the Small-Body DataBase for asteroids and comets based on specified constraints.

```APIDOC
## GET https://ssd-api.jpl.nasa.gov/sbdb_query.api

### Description
Request data for a set of asteroids and/or comets matching specified constraints.

### Method
GET

### Endpoint
https://ssd-api.jpl.nasa.gov/sbdb_query.api

### Parameters
#### Query Parameters
- **info** (string) - Optional - When `count` is selected, return the number of objects available. When `field` is selected, return all available output fields. If `all` is selected, output `count` and `field` results.
- **fields** (string) - Optional - List of fields to be output. Field names are case-sensitive.
- **sort** (string) - Optional - Sort results by the specified field(s). Up to three fields can be specified, separated by commas. Prefix with `-` for descending order.
- **limit** (number) - Optional - Limit data to the first N results.
- **limit-from** (number) - Optional - Limit data starting from the specified record (zero-indexed). Requires `limit`.
- **full-prec** (boolean) - Optional - Output data in full precision (default: false).
```

--------------------------------

### GET https://ssd.jpl.nasa.gov/api/horizons_lookup.api

Source: https://ssd-api.jpl.nasa.gov/doc/horizons_lookup.html

Retrieves a list of recognized aliases and synonyms for a specified object identifier.

```APIDOC
## GET https://ssd.jpl.nasa.gov/api/horizons_lookup.api

### Description
Process a user-specified name, designation, SPK-ID, IAU number, or other alias to return its primary synonyms and all aliases recognized by the JPL Horizons system.

### Method
GET

### Endpoint
https://ssd.jpl.nasa.gov/api/horizons_lookup.api

### Parameters
#### Query Parameters
- **sstr** (string) - Required - The object name, designation, SPK-ID, or alias to look up.
- **format** (string) - Optional - The output format (e.g., 'text'). Defaults to JSON if not specified.

### Request Example
https://ssd.jpl.nasa.gov/api/horizons_lookup.api?sstr=2004%20MN4
```
Tokens:
Raw