Automated Data Access

The NEOCC provides programmatic access to its data through a set of simple HTTPS GET endpoints that return plain-text responses. No authentication is required. All requests and parameters are passed directly in the URL.

Experimental interface. This API may be modified, changed, or removed at any moment without advance warning. A more convenient interface may be offered in the future. Best effort will be made to keep this page up to date with any changes.

Usage

Base URL

Every endpoint listed on this page must be prefixed with the server root:

https://neo.ssa.esa.int/

For example, the full URL for the All NEA list endpoint is:
https://neo.ssa.esa.int/PSDB-portlet/download?file=allneo.lst

URL encoding

Object designators that contain a space — such as 433 Eros — must be URL-encoded. Encode the space either as + or as %20. Most browsers handle this automatically, but some command-line tools (e.g. curl) may not. If the server returns 400 Bad Request, check that spaces in designators are properly encoded.

Correct:   PSDB-portlet/download?file=433+Eros.ke1
Correct:   PSDB-portlet/download?file=433%20Eros.ke1
Incorrect: PSDB-portlet/download?file=433 Eros.ke1    ← will likely fail

Parameters reference

Some endpoints accept parameters in the URL path, shown as $placeholder names.

Placeholder	Type	Description	Valid values
`$desig`	String	Object designator: name or provisional designation (no unencoded spaces). If numbered, the catalog number may precede the name separated by a space (URL-encoded). Examples: `2007VK184`, `433+Eros`.	Any object in the database for which the relevant data is available.
`$orbptype`	String	Orbital parameter type. Formed by two parts: the element type (`eq` = equinoctial, `ke` = Keplerian) followed by the epoch selector (`0` = middle of the observational arc, `1` = near current date).	`eq0`, `eq1`, `ke0`, `ke1`
`$obscode`	String	Observatory code for ephemerides generation. See the MPC list of observatory codes. Use `500` for the geocenter.	Any MPC-recognised code, or `500`.
`$tini` / `$tend`	UTC datetime	Start and end times for ephemerides generation. Format: `YYYY-MM-DDTHH:MMZ`. Example: `2033-08-31T11:37Z`.	End time must be after start time. Undisclosed limits apply to the distance from the present and the time span.
`$dt`	Real number	Time step for ephemerides generation. Must be positive.	Undisclosed limits apply to the total number of output lines.
`$dtunit`	String	Unit for `$dt`.	`days`, `hours`, `minutes`, `weeks`

List of API endpoints

Direct download of list files

These URLs require no parameters and can be called directly. They are equivalent to clicking the Download as TXT button on the relevant pages.

All NEA list Updated daily

URL: PSDB-portlet/download?file=allneo.lst

Output format: the list of all NEOs currently considered in the NEOCC system. Each line contains the numeric designation (or provisional designation) followed by the object name.

433       Eros
719       Albert
887       Alinda
1036      Ganymed
1221      Amor
1566      Icarus
...

Updated NEA list Updated daily

URL: PSDB-portlet/download?file=updated_nea.lst

Output format: the list of all NEAs updated by the NEOCC Orbit Determination system. The first line is a comment with the generation timestamp.

# Thu Mar 12 13:01:26 UTC 2026
1036      Ganymed
1620      Geographos
1685      Toro
1863      Antinous
1866      Sisyphus
...

All non-NEA list Updated monthly

URL: PSDB-portlet/download?file=not_neas.lst

Output format: the list of all non-NEAs currently considered in the NEOCC system.

1               Ceres
2               Pallas
3               Juno
4               Vesta
5               Astraea
...

Catalogue of NEAs (current date) Updated daily

URL: PSDB-portlet/download?file=neo_kc.cat

Output format: OEF 2.0 catalogue of Keplerian orbital elements computed near the current date, including absolute magnitude H, slope parameter G, and a flag for non-gravitational parameters.

format  = 'OEF2.0'       ! file format
rectype = '1L'           ! record type (1L/ML)
elem    = 'KEP'          ! type of orbital elements
refsys  = ECLM J2000     ! default reference system
END_OF_HEADER
! Name, Epoch(MJD), a, e, i, long. node, arg. peric., mean anomaly, absolute magnitude, slope param, non-grav param
433             61000.000000    1.4581209994762865E+00   2.2283595154182145E-01   1.0828472614790059E+01   3.0427009758530204E+02   1.7892976343911880E+02   3.1055432257357319E+02  10.82  0.46  0
719             61000.000000    2.6365903926432961E+00   5.4659579995328422E-01   1.1573112280803114E+01   1.8386097744905626E+02   1.5618939496854489E+02   2.4061027374592911E+02  15.59  0.15  0
887             61000.000000    2.4736287789638522E+00   5.7116997942715297E-01   9.4000596257086499E+00   1.1040587138771301E+02   3.5053450697452848E+02   8.1540592941245237E+01  13.41 -0.12  0
1036            61200.000000    2.6640688138170638E+00   5.3350067453088823E-01   2.6687654329884847E+01   2.1539772472045507E+02   1.3250731109574446E+02   1.4296531352982589E+02   9.42  0.30  0
1221            61000.000000    1.9198312596600744E+00   4.3463234438769088E-01   1.1868824198707738E+01   1.7123717861350909E+02   2.6758232081173908E+01   5.9870488392435931E+01  17.48  0.15  1
1566            61000.000000    1.0780378365885841E+00   8.2700569503686927E-01   2.2803209454538223E+01   8.7952422242776095E+01   3.1438211624796079E+01   1.5307893404793032E+02  16.53  0.15  1
...

Catalogue of NEAs (middle arc) Updated daily

URL: PSDB-portlet/download?file=neo_km.cat

Output format: OEF 2.0 catalogue of Keplerian orbital elements computed near the middle of each object's observational arc; the epoch changes only when new observations are ingested.

Catalogue of NEA orbits in equinoctial elements (current epoch) Updated daily

URL: PSDB-portlet/download?file=neo.ctc

Output format: OEF 2.0 catalogue of NEA orbits near the current epoch in equinoctial elements, including covariance and normal matrix information.

format  = 'OEF2.0'       ! file format
rectype = 'ML'           ! record type (1L/ML)
refsys  = ECLM J2000     ! default reference system
END_OF_HEADER
433
! Equinoctial elements: a, e*sin(LP), e*cos(LP), tan(i/2)*sin(LN), tan(i/2)*cos(LN), mean long.
 EQU   1.4581209994762865E+00   1.8646146796693505E-01  -1.2201631965915317E-01   -0.078324243972145    0.053369299442852   73.754183597994
 MJD     61000.000000000 TDT
 MAG  10.820  0.460
! Non-gravitational parameters: model used, number of model parameters, dimension
 LSP   0  0    6
! RMS    2.15646E-10   1.00172E-08   1.25808E-08   1.34949E-08   1.37857E-08   1.62282E-06
! EIG   1.16203E-10   5.73077E-09   9.21319E-09   1.30612E-08   1.42890E-08   1.62287E-06
! WEA   0.00005   0.00174   0.00680  -0.00047  -0.00174  -0.99997
 COV   4.650310706024053E-20 -1.850126966326726E-20 -4.509553156651866E-20
 COV  -5.296751393172420E-20 -2.460762342762070E-19 -1.304903029544441E-16
 COV   1.003445087718637E-16  3.418924846997194E-17  5.530036960610916E-18
 COV   1.611259257475352E-17 -4.571399720107907E-15  1.582759340306774E-16
 COV   5.116977700031709E-18 -1.445887085666752E-17 -1.791410512693996E-14
 COV   1.821136351669101E-16 -1.871824826739447E-17  1.246130439831623E-15
 COV   1.900466741603930E-16  4.570353753069790E-15  2.633553439989999E-12
 NOR   7.399773634907408E+19  2.028806074174246E+17  2.053946105844838E+18
 NOR  -1.922614195375074E+17 -2.284163182565638E+17  1.847753202841878E+16
 NOR   1.183977206537267E+16  5.633550191566405E+15 -1.185580874348508E+15
 NOR  -2.191795705347635E+15  7.328993602875944E+13  8.680868156074534E+16
 NOR  -7.915105143603700E+15 -9.357027459531448E+15  7.220287452421549E+14
 NOR   6.343611865891317E+15  1.585937547551701E+15 -7.117884953958862E+13
 NOR   6.792099311672704E+15 -9.130896696883553E+13  6.526044750871508E+12
719
...

Catalogue of NEA orbits in equinoctial elements (middle arc) Updated daily

URL: PSDB-portlet/download?file=neo.ctm

Output format: OEF 2.0 catalogue of NEA orbits computed near the midpoint epoch of each object's observational arc, expressed in equinoctial elements and including covariance and normal matrix information.

Monthly computation date Updated monthly

URL: PSDB-portlet/download?file=monthly_update.done

Output format: a single line with the date of the latest monthly run by the NEOCC Orbit Determination system.

Mon Nov 24 18:03:35 UTC 2025

Risk list (normal) Updated daily

URL: PSDB-portlet/download?file=esa_risk_list

Output format: a line with the last update timestamp, followed by a pipe-delimited (|) table. The first three lines are headers. An asterisk in the diameter field indicates a value estimated from the absolute magnitude.

Last Update: 2026-03-05 17:37 UTC
           Object             |    Diameter    |             VI Max                                   |          VIs                  |
Num/des.           Name       |   m  |   *=Y   |      Date/Time   |  IP max  | PS max |TS  | Vel km/s | Years     | IP cum   | PS cum |
AAAAAAAAAAAA AAAAAAAAAAAAAAAA | NNNN |    A    | YYYY-MM-DD HH:MM | EEEEEEEE | NNN.NN | NN |  NNN.NN  | YYYY-YYYY | EEEEEEEE | NNN.NN |
2023VD3                       |   14 |    *    | 2034-11-08 17:08 |  2.35E-3 |  -2.67 |  0 |   21.01  | 2034-2039 |  2.35E-3 |  -2.67 |
2008JL3                       |   30 |    *    | 2027-05-01 09:05 |  1.49E-4 |  -2.73 |  0 |   14.01  | 2027-2122 |  1.61E-4 |  -2.73 |
1979XB                        |  500 |    *    | 2056-12-12 21:38 |  2.34E-7 |  -2.82 |  0 |   27.54  | 2056-2113 |  7.34E-7 |  -2.70 |
2000SG344                     |   40 |    *    | 2071-09-16 00:54 |  8.95E-4 |  -3.18 |  0 |   11.27  | 2069-2122 |  2.82E-3 |  -2.77 |
...

Risk list (special) Updated as needed

URL: PSDB-portlet/download?file=esa_special_risk_list

Last Update: 2026-03-06 13:18 UTC
           Object             |    Diameter    |             VI Max                                   |
Num/des.           Name       |   m  |   *=Y   |      Date/Time   |  IP max  | PS max |TS  | Vel km/s |
AAAAAAAAAAAA AAAAAAAAAAAAAAAA | NNNN |    A    | YYYY-MM-DD HH:MM | EEEEEEEE | NNN.NN | NN |  NNN.NN  |
101955                  Bennu |  484 |         | 2182-09-24 20:24 |  3.70E-4 |  -1.59 |    |   12.68  |
29075                  1950DA | 1300 |         | 2880-03-16 23:48 |  1.96E-5 |  -2.13 |    |   17.99  |

Close approaches (upcoming) Updated daily

URL: PSDB-portlet/download?file=esa_upcoming_close_app

Output format: a line with the last update timestamp, followed by a pipe-delimited (|) table. The first three lines are headers. An asterisk in the diameter field indicates an estimated value.

Last Update: 2026-03-06 14:40 UTC
           Object             |            |   Miss Distance             |     Diameter     |  H   | Max bright | Rel. vel | CAI index  |
Num/des.           Name       | Date       |    km   |    au    |   LD   |   m    |  *=Yes  | mag  |   mag      | km/s     |            |
AAAAAAAAAAAA AAAAAAAAAAAAAAAA | YYYY-MM-DD | DDDDDDD | D.DDDDDD | DD.DDD | NNNN   |   A     | DD.D |   DDD.D    | DD.D     | DDD.DDD    |
2026DM15                      | 2026-03-06 | 4712193 | 0.031499 | 12.259 |  100   |   *     | 22.7 |    18.4    |  7.9     |   1.133    |
2021ER                        | 2026-03-07 | 2602263 | 0.017395 |  6.770 |   15   |   *     | 26.9 |    20.4    |  3.9     |   2.627    |
2026DW14                      | 2026-03-07 | 4798840 | 0.032078 | 12.484 |   20   |   *     | 26.3 |    21.3    | 12.0     |   3.437    |
2026DG7                       | 2026-03-07 | 3598333 | 0.024053 |  9.361 |   30   |   *     | 25.4 |    19.4    | 16.0     |   2.702    |
2012DF31                      | 2026-03-08 | 5148307 | 0.034414 | 13.393 |   40   |   *     | 24.6 |    20.6    | 16.0     |   2.431    |
2026DM8                       | 2026-03-08 | 6017635 | 0.040225 | 15.655 |   30   |   *     | 25.1 |    20.7    | 15.8     |   2.946    |
2026DY7                       | 2026-03-08 | 3489107 | 0.023323 |  9.077 |   21   |   *     | 26.2 |    20.5    |  7.7     |   2.863    |
...

Close approaches (recent) Updated daily

URL: PSDB-portlet/download?file=esa_recent_close_app

Output format: equal to the upcoming close approaches list.

Close encounters list Updated daily

URL: PSDB-portlet/download?file=close_encounter2.txt

Output format: a pipe-delimited list of all computed close encounters between asteroids and the Earth with a closest-approach distance smaller than 0.2 au.

Fri Mar 06 14:31:08 UTC 2026
 Name/desig    | Planet | Date             | Time approach   | Time uncert     | Distance              | Minimum distance      | Distance uncertainty  | Width     | Stretch   | Probability | Velocity     | Max Mag
 DDDDDDDDDDDDD | AAAAA  | YYYY/MM/DD.DDDDD | DDDDD.DDDDDDDDD | E.EEEEEEEEEEEEE | E.EEEEEEEEEEEEEEEEEEE | E.EEEEEEEEEEEEEEEEEEE | E.EEEEEEEEEEEEEEEEEEE | E.EEEEEEE | E.EEEEEEE | E.EEEEEE    | DDD.DDDDDDDD | DDD.DDD
           433 | EARTH  | 1975/01/23.31854 | 42435.318542643 | 1.116398341E-05 | 1.511341372748696E-01 | 1.511340844281232E-01 | 1.762080748547246E-08 | 1.273E-08 | 5.424E-08 | 1.00E+00    |   5.82530834 |   7.389
           433 | EARTH  | 2012/01/31.45798 | 55957.457983474 | 8.832411497E-06 | 1.786758177820283E-01 | 1.786757964049225E-01 | 7.129255448814371E-09 | 7.098E-09 | 2.815E-08 | 1.00E+00    |   5.94520144 |   8.215
           433 | EARTH  | 2056/01/24.45956 | 72021.459561290 | 1.194090874E-05 | 1.497821887353720E-01 | 1.497821404613323E-01 | 1.608883790940492E-08 | 1.309E-08 | 6.076E-08 | 1.00E+00    |   5.82076352 |   7.293
           433 | EARTH  | 2093/01/31.65666 | 85543.656658021 | 1.670329066E-05 | 1.824635809227585E-01 | 1.824633884125288E-01 | 6.417296255735153E-08 | 1.607E-08 | 1.222E-07 | 1.00E+00    |   5.97491046 |   8.300
           887 | EARTH  | 1974/01/04.20812 | 42051.208117263 | 1.833980291E-05 | 1.367787401125133E-01 | 1.367787163561867E-01 | 7.973592177403838E-09 | 3.596E-09 | 1.454E-07 | 1.00E+00    |   7.09597352 |  10.146
...

Impacted objects Updated as needed

URL: /PSDB-portlet/download?file=past_impactors_list

Output format: a pipe-delimited table of objects that have impacted Earth, including diameter, impact date/time, velocity, estimated energy, and measured energy.

Last Update: 2024-12-04 11:00 UTC
  Object Designation  |     Diameter in m     |  Impact date/time in UTC  |  Impact Velocity in km/s  |  Impact FPA in deg  |  Impact azimuth in deg  |  Estimated energy in kt  |  Estimated energy from other sources in kt  |
       2024XA1        |         1.0*          |    2024-12-03 16:15:01    |           15.52           |        -50.6        |          35.0           |          0.0316          |                     n/a                     |
        2024UQ        |         0.9*          |    2024-10-22 10:54:29    |           23.43           |        -58.3        |          67.8           |          0.0782          |                    0.015                    |
       2024RW1        |         1.4*          |    2024-09-04 16:39:33    |           20.60           |        -57.0        |          40.6           |          0.187           |                     0.2                     |
       2024BX1        |         1.0*          |    2024-01-21 00:32:44    |           15.26           |        -75.4        |          74.2           |          0.0405          |                     n/a                     |
       2023CX1        |         1.0*          |    2023-02-13 02:59:22    |           14.02           |        -49.2        |          101.4          |          0.0403          |                     n/a                     |
...

30-days ephemeris catalogue Updated daily

URL: PSDB-portlet/download?file=allnea_30d.eph

Output format: a fixed-width table of 30 days of ephemerides for all NEAs, including MJD, equatorial coordinates, magnitude, elongation, phase angle, galactic latitude, Earth and Sun distances, sky motion, uncertainty ellipse, MOID, and arc length.

Name            MJD         RA         DEC    Vmag    elong  phase  gallat.  d_earth d_sun   Motion & Dir.           Uncertainty Ellipse          MOID  unobs  arc
               (UTC)       (deg)      (deg)           (deg)   (deg)   (deg)    (au)   (au)  (deg/day) (deg)      (arcmin)    (arcmin)  (deg)       (au) (days)(days)
         433 61106.00000  77.94059  16.95725  11.32  -92.34   60.31  -13.04   0.525  1.141   0.961  105.054        0.000        0.000    6.20    0.1492    20 48321
         433 61107.00000  78.91046  16.70714  11.33  -92.25   60.27  -12.41   0.528  1.142   0.961  105.108        0.000        0.000    6.56    0.1492    20 48321
         433 61108.00000  79.87880  16.45616  11.34  -92.16   60.21  -11.77   0.530  1.143   0.961  105.160        0.000        0.000    6.92    0.1492    20 48321
         433 61109.00000  80.84554  16.20437  11.35  -92.07   60.16  -11.13   0.533  1.144   0.961  105.212        0.000        0.000    7.26    0.1491    20 48321
         433 61110.00000  81.81059  15.95181  11.37  -91.99   60.10  -10.49   0.536  1.145   0.961  105.262        0.000        0.000    7.59    0.1491    20 48321
         433 61111.00000  82.77390  15.69852  11.38  -91.91   60.03   -9.84   0.539  1.146   0.961  105.311        0.000        0.000    7.91    0.1490    20 48321
         433 61112.00000  83.73539  15.44456  11.39  -91.83   59.97   -9.18   0.542  1.147   0.960  105.359        0.000        0.000    8.21    0.1490    20 48321
...

Direct download of data on an object

These URLs are parameterised with a specific object designator. They are equivalent to clicking the Download as TXT button in the relevant tab of the object details page. See the Parameters reference above for valid placeholder values.

Asteroid orbit properties On NEA sync

URL: PSDB-portlet/download?file=$desig.$orbptype

Output format: OEF 2.0 format as used by OrbFit, including Keplerian or equinoctial elements, covariance and normal matrices, and RMS values.

Asteroid physical properties On demand

URL: PSDB-portlet/download?file=$desig.phypro

Output format: a CSV-like summary of physical properties (rotation period, taxonomy, albedo, diameter, colour indices, etc.) followed by a REFERENCES section.

Asteroid observation records On NEA sync

URL: PSDB-portlet/download?file=$desig.rwo

Output format: fixed-width OrbFit observation file containing optical and radar astrometry with residuals, RMS values, and catalogue information.

Generation of observational ephemerides for an object On NEA sync

URL: PSDB-portlet/ephemerides?des=$desig&oc=$obscode&t0=$tini&t1=$tend&ti=$dt&tiu=$dtunit

Output format: a header block summarising the query parameters, followed by a fixed-width table of Right Ascension and Declintion in equatorial coordinates, magnitude, airmass, elongation, sky-plane uncertainties, and apparent motion.

Asteroid close approach report On NEA sync

URL: PSDB-portlet/download?file=$desig.clolin

Output format: a space-separated table of close encounter parameters — calendar time, MJD, time uncertainty, nominal and minimum possible distance, distance uncertainty, stretch, width, and probability.

Possible impacts On NEA sync

URL: PSDB-portlet/download?file=$desig.risk

Output format: the first line gives the object name; the next four are column headers; subsequent lines list all virtual impactors (date, sigma, nominal distance, impact probability, Palermo Scale, Torino Scale). The file ends with additional orbit determination details.

✓ Python snippet copied to clipboard