{"openapi":"3.1.0","info":{"title":"Asteroid Close Approaches API","version":"1.0.0","description":"Live near-Earth object close approaches as an API, straight from NASA/JPL's Close-Approach Data (CAD) system. List the asteroids and comets passing nearest Earth over the next N days (or look back), with the approach date, miss distance (in astronomical units, lunar distances and kilometres), relative velocity and an estimated diameter from the object's absolute magnitude; or pull the full close-approach history for a specific object (e.g. 99942 Apophis, 101955 Bennu). Ideal for planetary-defense dashboards, astronomy & space apps, education and \"asteroid of the week\" content.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/closeapproach-api","description":"oanor gateway"}],"tags":[{"name":"Close Approaches"},{"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/approaches":{"get":{"operationId":"get_v1_approaches","tags":["Close Approaches"],"summary":"Upcoming (or past) close approaches","description":"","parameters":[{"name":"days","in":"query","required":false,"description":"Window in days from now (default 60)","schema":{"type":"string"},"example":"60"},{"name":"dist_max","in":"query","required":false,"description":"Max miss distance in AU (default 0.05 ≈ 19.5 LD)","schema":{"type":"string"},"example":"0.05"},{"name":"past","in":"query","required":false,"description":"true = look back instead of forward","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (1-100, default 50)","schema":{"type":"string"},"example":"50"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":23,"total":23,"approaches":[{"date":"2026-May-31 00:54","object":"2026 KJ2","distance":{"au":0.044786,"km":6699907,"lunar":17.43},"fullname":"(2026 KJ2)","estimated_diameter":{"max_km":0.041,"min_km":0.018},"absolute_magnitude_h":25.807,"relative_velocity_km_s":7.212},{"date":"2026-May-31 01:31","object":"2026 KA3","distance":{"au":0.024714,"km":3697202,"lunar":9.62},"fullname":"(2026 KA3)","estimated_diameter":{"max_km":0.044,"min_km":0.02},"absolute_magnitude_h":25.654,"relative_velocity_km_s":9.333},{"date":"2026-Jun-01 03:26","object":"2026 KV","distance":{"au":0.02598,"km":3886503,"lunar":10.11},"fullname":"(2026 KV)","estimated_diameter":{"max_km":0.045,"min_km":0.02},"absolute_magnitude_h":25.611,"relative_velocity_km_s":10.935},{"date":"2026-Jun-01 10:13","object":"2026 JN","distance":{"au":0.040903,"km":6119027,"lunar":15.92},"fullname":"(2026 JN)","estimated_diameter":{"max_km":0.083,"min_km":0.037},"absolute_magnitude_h":24.281,"relative_velocity_km_s":7.77},{"date":"2026-Jun-01 11:35","object":"2026 KO3","distance":{"au":0.044234,"km":6617240,"lunar":17.21},"fullname":"(2026 KO3)","estimated_diameter":{"max_km":0.076,"min_km":0.034},"absolute_magnitude_h":24.468,"relative_velocity_km_s":12.867},{"date":"2026-Jun-01 23:35","object":"2026 KB1","distance":{"au":0.026218,"km":3922085,"lunar":10.2},"fullname":"(2026 KB1)","estimated_diameter":{"max_km":0.222,"min_km":0.099},"absolute_magnitude_h":22.142,"relative_velocity_km_s":13.515},{"date":"2026-Jun-03 06:52","object":"2021 KN2","distance":{"au":0.022879,"km":3422713,"lunar":8.9},"fullname":"(2021 KN2)","estimated_diameter":{"max_km":0.011,"min_km":0.005},"absolute_magnitude_h":28.63,"relative_velocity_km_s":8.914},{"date":"2026-Jun-07 14:05","object":"2018 GE","distance":{"au":0.041896,"km":6267506,"lunar":16.3},"fullname":"(2018 GE)","estimated_diameter":{"max_km":0.019,"min_km":0.008},"absolute_magnitude_h":27.5,"relative_velocity_km_s":3.094},{"date":"2026-Jun-09 05:19","object":"2026 KM3","distance":{"au":0.015795,"km":2362877,"lunar":6.15},"fullname":"(2026 KM3)","estimated_diameter":{"max_km":0.056,"min_km":0.025},"absolute_magnitude_h":25.12,"relative_velocity_km_s":8.762},{"date":"2026-Jun-12 18:59","object":"530520","distance":{"au":0.041146,"km":6155404,"lunar":16.01},"fullname":"530520 (2011 LT17)","estimated_diameter":{"max_km":0.254,"min_km":0.113},"absolute_magnitude_h":21.85,"relative_velocity_km_s":14.57},{"date":"2026-Jun-18 20:57","object":"2003 LN6","distance":{"au":0.009472,"km":1416923,"lunar":3.69},"fullname":"(2003 LN6)","estimated_diameter":{"max_km":0.068,"min_km":0.03},"absolute_magnitude_h":24.71,"relative_velocity_km_s":3.92},{"date":"2026-Jun-21 04:02","object":"2025 WC4","distance":{"au":0.026082,"km":3901754,"lunar":10.15},"fullname":"(2025 WC4)","estimated_diameter":{"max_km":0.508,"min_km":0.227},"absolute_magnitude_h":20.34,"relative_velocity_km_s":19.18},{"date":"2026-Jun-22 10:41","object":"2015 LM24","distance":{"au":0.046471,"km":6951975,"lunar":18.09},"fullname":"(2015 LM24)","estimated_diameter":{"max_km":0.119,"min_km":0.053},"absolute_magnitude_h":23.5,"relative_velocity_km_s":13.752},{"date":"2026-Jun-27 11:16","object":"152637","distance":{"au":0.017152,"km":2565839,"lunar":6.67},"fullname":"152637 (1997 NC1)","estimated_diameter":{"max_km":1.585,"min_km":0.709},"absolute_magnitude_h":17.87,"relative_velocity_km_s":8.887},{"date":"2026-Jul-04 19:53","object":"523808","distance":{"au":0.023242,"km":3476894,"lunar":9.04},"fullname":"523808 (2007 ML24)","estimated_diameter":{"max_km":0.802,"min_km":0.359},"absolute_magnitude_h":19.35,"relative_velocity_km_s":16.765},{"date":"2026-Jul-05 11:39","object":"2023 YO1","distance":{"au":0.016716,"km":2500656,"lunar":6.51},"fullname":"(2023 YO1)","estimated_diameter":{"max_km":0.039,"min_km":0.017},"absolute_magnitude_h":25.93,"relative_velocity_km_s":2.712},{"date":"2026-Jul-11 06:06","object":"2007 AA2","distance":{"au":0.045671,"km":6832281,"lunar":17.77},"fullname":"(2007 AA2)","estimated_diameter":{"max_km":0.071,"min_km":0.032},"absolute_magnitude_h":24.6,"relative_velocity_km_s":7.214},{"date":"2026-Jul-17 21:09","object":"2025 PN7","distance":{"au":0.029786,"km":4455989,"lunar":11.59},"fullname":"(2025 PN7)","estimated_diameter":{"max_km":0.031,"min_km":0.014},"absolute_magnitude_h":26.41,"relative_velocity_km_s":2.617},{"date":"2026-Jul-19 01:55","object":"2025 MB90","distance":{"au":0.012935,"km":1935053,"lunar":5.03},"fullname":"(2025 MB90)","estimated_diameter":{"max_km":0.09,"min_km":0.04},"absolute_magnitude_h":24.11,"relative_velocity_km_s":9.582},{"date":"2026-Jul-21 06:16","object":"2020 OM","distance":{"au":0.023321,"km":3488749,"lunar":9.08},"fullname":"(2020 OM)","estimated_diameter":{"max_km":0.024,"min_km":0.011},"absolute_magnitude_h":26.93,"relative_velocity_km_s":9.461},{"date":"2026-Jul-24 00:21","object":"2026 KU3","distance":{"au":0.019672,"km":2942815,"lunar":7.66},"fullname":"(2026 KU3)","estimated_diameter":{"max_km":0.132,"min_km":0.059},"absolute_magnitude_h":23.268,"relative_velocity_km_s":8.583},{"date":"2026-Jul-25 14:48","object":"2020 UR1","distance":{"au":0.04819,"km":7209049,"lunar":18.75},"fullname":"(2020 UR1)","estimated_diameter":{"max_km":0.047,"min_km":0.021},"absolute_magnitude_h":25.5,"relative_velocity_km_s":7.635},{"date":"2026-Jul-26 23:39","object":"2015 BF","distance":{"au":0.044331,"km":6631829,"lunar":17.25},"fullname":"(2015 BF)","estimated_diameter":{"max_km":0.028,"min_km":0.013},"absolute_magnitude_h":26.6,"relative_velocity_km_s":12.51}],"dist_max_au":0.05,"window_days":60},"meta":{"timestamp":"2026-05-31T06:28:02.103Z","request_id":"7c57f6db-9f94-4ed4-b33c-a8517a9976b3"},"status":"ok","message":"Close approaches 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/object":{"get":{"operationId":"get_v1_object","tags":["Close Approaches"],"summary":"Full close-approach history for one object","description":"","parameters":[{"name":"des","in":"query","required":true,"description":"Object designation/number, e.g. 99942 (Apophis)","schema":{"type":"string"},"example":"99942"},{"name":"limit","in":"query","required":false,"description":"Max results (1-200, default 50)","schema":{"type":"string"},"example":"50"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":6,"total":6,"object":"99942","approaches":[{"date":"1907-Apr-13 01:12","object":"99942","distance":{"au":0.028613,"km":4280482,"lunar":11.14},"fullname":"99942 Apophis (2004 MN4)","estimated_diameter":{"max_km":0.904,"min_km":0.404},"absolute_magnitude_h":19.09,"relative_velocity_km_s":5.097},{"date":"1949-Apr-14 11:30","object":"99942","distance":{"au":0.027961,"km":4182895,"lunar":10.88},"fullname":"99942 Apophis (2004 MN4)","estimated_diameter":{"max_km":0.904,"min_km":0.404},"absolute_magnitude_h":19.09,"relative_velocity_km_s":6.69},{"date":"1990-Apr-14 20:44","object":"99942","distance":{"au":0.032929,"km":4926157,"lunar":12.82},"fullname":"99942 Apophis (2004 MN4)","estimated_diameter":{"max_km":0.904,"min_km":0.404},"absolute_magnitude_h":19.09,"relative_velocity_km_s":6.845},{"date":"1998-Apr-14 19:46","object":"99942","distance":{"au":0.024387,"km":3648258,"lunar":9.49},"fullname":"99942 Apophis (2004 MN4)","estimated_diameter":{"max_km":0.904,"min_km":0.404},"absolute_magnitude_h":19.09,"relative_velocity_km_s":6.585},{"date":"2029-Apr-13 21:46","object":"99942","distance":{"au":0.000254,"km":38011,"lunar":0.1},"fullname":"99942 Apophis (2004 MN4)","estimated_diameter":{"max_km":0.904,"min_km":0.404},"absolute_magnitude_h":19.09,"relative_velocity_km_s":7.423},{"date":"2051-Apr-20 02:05","object":"99942","distance":{"au":0.04149,"km":6206849,"lunar":16.15},"fullname":"99942 Apophis (2004 MN4)","estimated_diameter":{"max_km":0.904,"min_km":0.404},"absolute_magnitude_h":19.09,"relative_velocity_km_s":4.694}]},"meta":{"timestamp":"2026-05-31T06:28:02.478Z","request_id":"ff35241a-87b0-4ca2-b650-7344f144d96e"},"status":"ok","message":"Object approaches 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/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Source & units","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Live close approaches of near-Earth asteroids and comets. dist_max in AU (default 0.05 ≈ 19.5 lunar distances). Diameter estimated from absolute magnitude.","units":{"au":"astronomical units","km":"kilometres","lunar":"lunar distances (1 LD = 384,400 km)","velocity":"km/s relative to Earth"},"source":"NASA/JPL CAD — Close-Approach Data API","endpoints":["/v1/approaches","/v1/object","/v1/meta"]},"meta":{"timestamp":"2026-05-31T06:28:02.554Z","request_id":"6c7a585a-d2e7-4d64-8c3d-c9e9c31a03e1"},"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":3500,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":650,"monthly_call_quota":45000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1950,"monthly_call_quota":240000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":4900,"monthly_call_quota":1300000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/closeapproach-api"}