{"openapi":"3.1.0","info":{"title":"Asteroids API","version":"1.0.0","description":"The NASA/JPL Small-Body Database (SBDB) as an API — 30,000+ named asteroids and comets with their physical and orbital properties. Look up any minor body by number (e.g. 1 → Ceres), name (Vesta) or SPK-ID; search by name with filters for orbit class, near-Earth (NEO) and potentially-hazardous (PHA) status; or list every near-Earth object. Each record carries the diameter, albedo, absolute magnitude, rotation period and the osculating orbit (semi-major axis, eccentricity, inclination, period) plus the orbit class (main-belt, Apollo, Trojan, …). Ideal for astronomy apps, planetarium software, education and space dashboards.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/asteroids-api","description":"oanor gateway"}],"tags":[{"name":"Asteroids"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/asteroid":{"get":{"operationId":"get_v1_asteroid","tags":["Asteroids"],"summary":"A single minor body by number, name or SPK-ID","description":"","parameters":[{"name":"number","in":"query","required":false,"description":"Asteroid number, e.g. 1 (Ceres)","schema":{"type":"string"},"example":"1"},{"name":"name","in":"query","required":false,"description":"Name, e.g. Vesta","schema":{"type":"string"}},{"name":"spkid","in":"query","required":false,"description":"JPL SPK-ID","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"neo":false,"pha":false,"name":"Ceres","orbit":{"eccentricity":0.0796,"period_years":4.6,"inclination_deg":10.59,"semi_major_axis_au":2.766},"spkid":20000001,"albedo":0.09,"number":1,"designation":"1 Ceres (A801 AA)","diameter_km":939.4,"orbit_class":"MBA","rotation_hours":9.0742,"abs_magnitude_h":3.35,"orbit_class_name":"Main-belt Asteroid"},"meta":{"timestamp":"2026-05-31T04:30:16.099Z","request_id":"7d1d241d-62e9-410b-9566-feb8b50dce9c"},"status":"ok","message":"Minor body retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/neo":{"get":{"operationId":"get_v1_neo","tags":["Asteroids"],"summary":"Near-Earth objects (optionally hazardous only)","description":"","parameters":[{"name":"pha","in":"query","required":false,"description":"true = potentially-hazardous only","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (1-100, default 25)","schema":{"type":"string"},"example":"25"},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":25,"limit":25,"total":389,"offset":0,"results":[{"neo":true,"pha":false,"name":"Eros","number":433,"designation":"433 Eros (A898 PA)","diameter_km":16.84,"orbit_class":"AMO","abs_magnitude_h":10.39},{"neo":true,"pha":false,"name":"Albert","number":719,"designation":"719 Albert (A911 TB)","orbit_class":"AMO","abs_magnitude_h":15.59},{"neo":true,"pha":false,"name":"Alinda","number":887,"designation":"887 Alinda (A918 AA)","diameter_km":4.2,"orbit_class":"AMO","abs_magnitude_h":13.82},{"neo":true,"pha":false,"name":"Ganymed","number":1036,"designation":"1036 Ganymed (A924 UB)","diameter_km":37.675,"orbit_class":"AMO","abs_magnitude_h":9.17},{"neo":true,"pha":false,"name":"Amor","number":1221,"designation":"1221 Amor (1932 EA1)","diameter_km":1,"orbit_class":"AMO","abs_magnitude_h":17.37},{"neo":true,"pha":true,"name":"Icarus","number":1566,"designation":"1566 Icarus (1949 MA)","diameter_km":1,"orbit_class":"APO","abs_magnitude_h":16.53},{"neo":true,"pha":false,"name":"Betulia","number":1580,"designation":"1580 Betulia (1950 KA)","diameter_km":5.8,"orbit_class":"AMO","abs_magnitude_h":14.54},{"neo":true,"pha":true,"name":"Geographos","number":1620,"designation":"1620 Geographos (1951 RA)","diameter_km":2.56,"orbit_class":"APO","abs_magnitude_h":15.26},{"neo":true,"pha":false,"name":"Ivar","number":1627,"designation":"1627 Ivar (1929 SH)","diameter_km":9.12,"orbit_class":"AMO","abs_magnitude_h":12.79},{"neo":true,"pha":false,"name":"Toro","number":1685,"designation":"1685 Toro (1948 OA)","diameter_km":3.4,"orbit_class":"APO","abs_magnitude_h":14.28},{"neo":true,"pha":true,"name":"Apollo","number":1862,"designation":"1862 Apollo (1932 HA)","diameter_km":1.5,"orbit_class":"APO","abs_magnitude_h":16.09},{"neo":true,"pha":false,"name":"Antinous","number":1863,"designation":"1863 Antinous (1948 EA)","diameter_km":2.1,"orbit_class":"APO","abs_magnitude_h":15.35},{"neo":true,"pha":false,"name":"Daedalus","number":1864,"designation":"1864 Daedalus (1971 FA)","diameter_km":3.7,"orbit_class":"APO","abs_magnitude_h":14.83},{"neo":true,"pha":false,"name":"Cerberus","number":1865,"designation":"1865 Cerberus (1971 UA)","diameter_km":1.2,"orbit_class":"APO","abs_magnitude_h":16.77},{"neo":true,"pha":false,"name":"Sisyphus","number":1866,"designation":"1866 Sisyphus (1972 XA)","diameter_km":8.48,"orbit_class":"APO","abs_magnitude_h":12.48},{"neo":true,"pha":false,"name":"Quetzalcoatl","number":1915,"designation":"1915 Quetzalcoatl (1953 EA)","diameter_km":0.5,"orbit_class":"AMO","abs_magnitude_h":18.38},{"neo":true,"pha":false,"name":"Boreas","number":1916,"designation":"1916 Boreas (1953 RA)","diameter_km":3.5,"orbit_class":"AMO","abs_magnitude_h":14.93},{"neo":true,"pha":false,"name":"Cuyo","number":1917,"designation":"1917 Cuyo (1968 AA)","diameter_km":5.7,"orbit_class":"AMO","abs_magnitude_h":14.38},{"neo":true,"pha":false,"name":"Anteros","number":1943,"designation":"1943 Anteros (1973 EC)","diameter_km":2.3,"orbit_class":"AMO","abs_magnitude_h":15.68},{"neo":true,"pha":false,"name":"Tezcatlipoca","number":1980,"designation":"1980 Tezcatlipoca (1950 LA)","diameter_km":4.3,"orbit_class":"AMO","abs_magnitude_h":13.8},{"neo":true,"pha":true,"name":"Midas","number":1981,"designation":"1981 Midas (1973 EA)","diameter_km":3.4,"orbit_class":"APO","abs_magnitude_h":15.28},{"neo":true,"pha":false,"name":"Baboquivari","number":2059,"designation":"2059 Baboquivari (1963 UA)","orbit_class":"AMO","abs_magnitude_h":15.98},{"neo":true,"pha":false,"name":"Anza","number":2061,"designation":"2061 Anza (1960 UA)","diameter_km":2.6,"orbit_class":"AMO","abs_magnitude_h":16.7},{"neo":true,"pha":false,"name":"Aten","number":2062,"designation":"2062 Aten (1976 AA)","diameter_km":1.1,"orbit_class":"ATE","abs_magnitude_h":17.11},{"neo":true,"pha":false,"name":"Bacchus","number":2063,"designation":"2063 Bacchus (1977 HB)","diameter_km":1.024,"orbit_class":"APO","abs_magnitude_h":17.21}],"pha_only":false},"meta":{"timestamp":"2026-05-31T04:30:16.174Z","request_id":"59272ebd-651f-49c1-a168-3d6d659d5ac0"},"status":"ok","message":"Near-Earth objects listed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Asteroids"],"summary":"Search by name with class / NEO / PHA filters","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Name search, e.g. apollo","schema":{"type":"string"}},{"name":"class","in":"query","required":false,"description":"Orbit class, e.g. MBA, APO, ATE, TJN, TNO","schema":{"type":"string"},"example":"MBA"},{"name":"neo","in":"query","required":false,"description":"true = near-Earth objects only","schema":{"type":"string"}},{"name":"pha","in":"query","required":false,"description":"true = potentially-hazardous only","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results per page (1-100, default 20)","schema":{"type":"string"},"example":"20"},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"limit":20,"total":24029,"offset":0,"filters":{"class":"MBA"},"results":[{"neo":false,"pha":false,"name":"Ceres","number":1,"designation":"1 Ceres (A801 AA)","diameter_km":939.4,"orbit_class":"MBA","abs_magnitude_h":3.35},{"neo":false,"pha":false,"name":"Pallas","number":2,"designation":"2 Pallas (A802 FA)","diameter_km":513,"orbit_class":"MBA","abs_magnitude_h":4.11},{"neo":false,"pha":false,"name":"Juno","number":3,"designation":"3 Juno (A804 RA)","diameter_km":246.596,"orbit_class":"MBA","abs_magnitude_h":5.19},{"neo":false,"pha":false,"name":"Vesta","number":4,"designation":"4 Vesta (A807 FA)","diameter_km":522.77,"orbit_class":"MBA","abs_magnitude_h":3.25},{"neo":false,"pha":false,"name":"Astraea","number":5,"designation":"5 Astraea (A845 XA)","diameter_km":106.699,"orbit_class":"MBA","abs_magnitude_h":6.96},{"neo":false,"pha":false,"name":"Hebe","number":6,"designation":"6 Hebe (A847 NA)","diameter_km":185.18,"orbit_class":"MBA","abs_magnitude_h":5.61},{"neo":false,"pha":false,"name":"Iris","number":7,"designation":"7 Iris (A847 PA)","diameter_km":199.83,"orbit_class":"MBA","abs_magnitude_h":5.68},{"neo":false,"pha":false,"name":"Flora","number":8,"designation":"8 Flora (A847 UA)","diameter_km":147.491,"orbit_class":"MBA","abs_magnitude_h":6.62},{"neo":false,"pha":false,"name":"Metis","number":9,"designation":"9 Metis (A848 HA)","diameter_km":190,"orbit_class":"MBA","abs_magnitude_h":6.18},{"neo":false,"pha":false,"name":"Hygiea","number":10,"designation":"10 Hygiea (A849 GA)","diameter_km":407.12,"orbit_class":"MBA","abs_magnitude_h":5.65},{"neo":false,"pha":false,"name":"Parthenope","number":11,"designation":"11 Parthenope (A850 JA)","diameter_km":142.887,"orbit_class":"MBA","abs_magnitude_h":6.73},{"neo":false,"pha":false,"name":"Victoria","number":12,"designation":"12 Victoria (A850 RA)","diameter_km":115.087,"orbit_class":"MBA","abs_magnitude_h":7.29},{"neo":false,"pha":false,"name":"Egeria","number":13,"designation":"13 Egeria (A850 VA)","diameter_km":202.636,"orbit_class":"MBA","abs_magnitude_h":6.91},{"neo":false,"pha":false,"name":"Irene","number":14,"designation":"14 Irene (A851 KA)","diameter_km":152,"orbit_class":"MBA","abs_magnitude_h":6.55},{"neo":false,"pha":false,"name":"Eunomia","number":15,"designation":"15 Eunomia (A851 OA)","diameter_km":231.689,"orbit_class":"MBA","abs_magnitude_h":5.43},{"neo":false,"pha":false,"name":"Psyche","number":16,"designation":"16 Psyche (A852 FA)","diameter_km":222,"orbit_class":"MBA","abs_magnitude_h":6.2},{"neo":false,"pha":false,"name":"Thetis","number":17,"designation":"17 Thetis (A852 HA)","diameter_km":84.899,"orbit_class":"MBA","abs_magnitude_h":7.92},{"neo":false,"pha":false,"name":"Melpomene","number":18,"designation":"18 Melpomene (A852 MA)","diameter_km":139.594,"orbit_class":"MBA","abs_magnitude_h":6.35},{"neo":false,"pha":false,"name":"Fortuna","number":19,"designation":"19 Fortuna (A852 QA)","diameter_km":200,"orbit_class":"MBA","abs_magnitude_h":7.49},{"neo":false,"pha":false,"name":"Massalia","number":20,"designation":"20 Massalia (A852 SA)","diameter_km":135.68,"orbit_class":"MBA","abs_magnitude_h":6.54}]},"meta":{"timestamp":"2026-05-31T04:30:16.230Z","request_id":"2a1163de-016c-4155-864e-5079d541d547"},"status":"ok","message":"Minor bodies listed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Totals, NEO/PHA counts & orbit-class breakdown","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"neo":389,"pha":51,"note":"Named asteroids and comets. neo = near-Earth object, pha = potentially hazardous asteroid. Orbit values are osculating elements.","total":30021,"fields":["spkid","number","name","designation","neo","pha","diameter_km","albedo","orbit_class","abs_magnitude_h","rotation_hours","orbit"],"source":"NASA/JPL Small-Body Database (SBDB)","orbit_classes":[{"code":"MBA","count":24029},{"code":"PAR","count":1655},{"code":"OMB","count":857},{"code":"JFc","count":829},{"code":"COM","count":724},{"code":"HYP","count":518},{"code":"TJN","count":345},{"code":"IMB","count":291},{"code":"MCA","count":286},{"code":"HTC","count":111},{"code":"AMO","count":86},{"code":"APO","count":81},{"code":"ETc","count":77},{"code":"TNO","count":49},{"code":"CEN","count":25},{"code":"CTc","count":22},{"code":"JFC","count":17},{"code":"ATE","count":14},{"code":"AST","count":2},{"code":"IEO","count":2},{"code":"HYA","count":1}]},"meta":{"timestamp":"2026-05-31T04:30:16.284Z","request_id":"bc67b7df-15d9-473e-8c21-2abd309e19b7"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":4000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":600,"monthly_call_quota":55000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1800,"monthly_call_quota":280000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":4600,"monthly_call_quota":1300000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/asteroids-api"}