# NASA API: List near-Earth asteroids > Lists near-Earth asteroids that pass Earth between two UTC dates within a chosen distance, with approach times, size ranges, speed and hazard status. Unofficial. Not affiliated with or endorsed by NASA. - Page: https://fous.com/methods/nasa.gov/list-near-earth-asteroids - Method: `nasa.gov/list_near_earth_asteroids`, version 1 - Website: nasa.gov - Returns: asteroid name, closest approach time (UTC), miss distance, size range, speed, hazard status, JPL link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `end_date` | string | no | `"2026-10-06"` | Last UTC calendar day to include, as YYYY-MM-DD (for example 2026-10-06). Defaults to seven days after the start date and cannot be later. | | `start_date` | string | no | `"2026-09-29"` | First UTC calendar day to include, as YYYY-MM-DD (for example 2026-09-29). Defaults to today (UTC). | | `max_distance_miles` | number | no | | Maximum Earth miss distance in miles (for example 5000000). Defaults to 5,000,000 miles. Default 5000000. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "end_date": "2026-10-06", "start_date": "2026-09-29" } ``` Its output: ```json { "asteroids": [ { "speed_kmh": 27911.05, "speed_mph": 17343.12, "size_basis": "estimated from brightness", "asteroid_name": "2026 TL4", "jpl_page_link": "https://ssd.jpl.nasa.gov/tools/sbdb_lookup.html#/?sstr=2026%20TL4", "size_max_feet": 160.04, "size_min_feet": 71.57, "size_max_meters": 48.78, "size_min_meters": 21.81, "miss_distance_km": 6112843.08, "miss_distance_miles": 3798344.59, "potentially_hazardous": "no", "closest_approach_time_utc": "2026-09-29T02:55:18+00:00", "miss_distance_moon_distances": 15.9023 }, { "speed_kmh": 47168.85, "speed_mph": 29309.37, "size_basis": "estimated from brightness", "asteroid_name": "2017 TE2", "jpl_page_link": "https://ssd.jpl.nasa.gov/tools/sbdb_lookup.html#/?sstr=2017%20TE2", "size_max_feet": 432.54, "size_min_feet": 193.44, "size_max_meters": 131.84, "size_min_meters": 58.96, "miss_distance_km": 3160723.31, "miss_distance_miles": 1963982.41, "potentially_hazardous": "no", "closest_approach_time_utc": "2026-09-29T08:50:49+00:00", "miss_distance_moon_distances": 8.2225 }, { "speed_kmh": 39636.03, "speed_mph": 24628.69, "size_basis": "estimated from brightness", "asteroid_name": "2026 TG1", "jpl_page_link": "https://ssd.jpl.nasa.gov/tools/sbdb_lookup.html#/?sstr=2026%20TG1", "size_max_feet": 145.35, "size_min_feet": 65, "size_max_meters": 44.3, "size_min_meters": 19.81, "miss_distance_km": 2687422.27, "miss_distance_miles": 1669886.78, "potentially_hazardous": "no", "closest_approach_time_utc": "2026-09-29T12:16:32+00:00", "miss_distance_moon_distances": 6.9912 } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"nasa.gov/list_near_earth_asteroids","input":{"end_date":"2026-10-06","start_date":"2026-09-29"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Which near-Earth asteroids will pass Earth between 2026-09-29 and 2026-10-06 within 5 million miles, and when is each closest approach in UTC? - Show me potentially hazardous asteroids flying past our planet next week closer than 2 million miles, with their speeds and size estimates. - I need a list of asteroids approaching Earth from March 3 to March 10 within 1,000,000 miles, including miss distance and JPL links. - What near-Earth objects are passing by in the coming weeks on NASA's site, and how large and fast are they? - Give me the close approaches of near-Earth asteroids for 2026-11-01 through 2026-11-15 within 10 million miles, flagging which ones are classed as hazardous. ## Input schema ```json { "type": "object", "required": [], "properties": { "end_date": { "type": "string", "description": "Last UTC calendar day to include, as YYYY-MM-DD (for example 2026-10-06). Defaults to seven days after the start date and cannot be later." }, "start_date": { "type": "string", "description": "First UTC calendar day to include, as YYYY-MM-DD (for example 2026-09-29). Defaults to today (UTC)." }, "max_distance_miles": { "type": "number", "default": 5000000, "minimum": 0, "description": "Maximum Earth miss distance in miles (for example 5000000). Defaults to 5,000,000 miles." } } } ``` ## Output schema ```json { "type": "object", "required": [ "asteroids" ], "properties": { "asteroids": { "type": "array", "items": { "type": "object", "required": [ "asteroid_name", "closest_approach_time_utc", "miss_distance_miles", "miss_distance_km", "miss_distance_moon_distances", "size_min_meters", "size_max_meters", "size_min_feet", "size_max_feet", "size_basis", "speed_mph", "speed_kmh", "potentially_hazardous", "jpl_page_link" ], "properties": { "speed_kmh": { "type": "number" }, "speed_mph": { "type": "number" }, "size_basis": { "type": "string", "description": "Measured diameter or estimated from brightness; unavailable if no size or brightness is known." }, "asteroid_name": { "type": "string", "description": "Asteroid name or designation." }, "jpl_page_link": { "type": "string" }, "size_max_feet": { "type": [ "number", "null" ] }, "size_min_feet": { "type": [ "number", "null" ] }, "size_max_meters": { "type": [ "number", "null" ] }, "size_min_meters": { "type": [ "number", "null" ] }, "miss_distance_km": { "type": "number" }, "miss_distance_miles": { "type": "number" }, "potentially_hazardous": { "enum": [ "yes", "no" ], "type": "string" }, "closest_approach_time_utc": { "type": "string", "description": "Closest approach in UTC (ISO 8601)." }, "miss_distance_moon_distances": { "type": "number" } } }, "description": "Asteroid approaches ordered by closest approach time in UTC. Empty if none match." } } } ``` ## See more - [NASA API: List natural events](https://fous.com/methods/nasa.gov/list-natural-events.md): List EONET natural events with latest observations in the past number of days, most recent first. A country or region filter matches reported event locations against mapped boundaries; locations and ongoing status are approximate, and not all events have a reported size or strength. - [NASA API: Get astronomy picture of the day](https://fous.com/methods/nasa.gov/get-astronomy-picture-of-the-day.md): Returns NASA's Astronomy Picture of the Day for a date: title, explanation, featured media link, optional high-resolution link, and credit. - [NASA API: Get ISS sightings](https://fous.com/methods/nasa.gov/get-iss-sightings.md): Finds upcoming International Space Station sightings for a city in NASA's city list, with local start times, visibility and sky directions. Cities without scheduled passes return an empty list. - [NASA API: Search media](https://fous.com/methods/nasa.gov/search-images.md): Searches NASA public photos, videos or audio by words and creation year, returning matches in relevance order with thumbnails and full-size file links. - [NOAA API: List space weather alerts](https://fous.com/methods/swpc.noaa.gov/list-space-weather-alerts.md): Lists NOAA space weather alerts, warnings, watches and summaries issued in the last 1 to 7 days, newest first, with validity times and NOAA scale levels when the message gives them. - [Time and Date API: Count business days](https://fous.com/methods/timeanddate.com/count-business-days.md): Counts weekdays between two dates, excluding nationwide public holidays or, optionally, public holidays in a state or province, from Time and Date's published holiday calendar. - [parkrun.com API: Get parkrun event results](https://fous.com/methods/parkrun.com/get-event-results.md): Gets the latest or a dated public parkrun event result, with finishers in position order. If a name matches several events, the closest directory name match is used. - [USGS API: List significant earthquakes](https://fous.com/methods/earthquake.usgs.gov/list-significant-earthquakes.md): Lists significant worldwide earthquakes for the past day, week, or month, newest first, with USGS PAGER alert levels and impact summaries when USGS provides them. - [All NASA methods](https://fous.com/methods/nasa.gov.md)