{"uid":"cap_Ow_c22wRAO8CAjAorvxWz","slug":"space-objects-body-close-approaches-31f01148","name":"Space Objects - Body Close Approaches","description":"Past and future Earth close approaches of one asteroid or comet by designation, for example Apophis in 2029.","url":"https://space-objects.x402tookit.com/body-approaches?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["designation"],"properties":{"to":{"type":"string","description":"End date YYYY-MM-DD (default 2200-12-31)"},"from":{"type":"string","description":"Start date YYYY-MM-DD (default 1900-01-01)"},"limit":{"type":"integer","description":"Passes returned, 1 to 50 (default 20)"},"designation":{"type":"string","description":"Number or designation, for example 99942, 433 or 2004 MN4"},"maxDistanceLD":{"type":"number","description":"Maximum miss distance in lunar distances, 0.1 to 200 (default 20)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"to":{"type":["null","string"]},"asOf":{"type":["null","string"]},"from":{"type":["null","string"]},"source":{"type":["null","string"]},"closest":{"type":["null","object"],"properties":{"distanceKm":{"type":["null","number"]},"approachTdb":{"type":["null","string"]},"distanceLunar":{"type":["null","number"]}}},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"returned":{"type":["null","number"]},"sourceUrl":{"type":["null","string"]},"approaches":{"type":["array","null"],"items":{"type":"object","properties":{"name":{"type":["null","string"]},"distanceAu":{"type":["null","number"]},"distanceKm":{"type":["null","number"]},"approachTdb":{"type":["null","string"]},"daysFromNow":{"type":["null","number"]},"designation":{"type":["null","string"]},"distanceLunar":{"type":["null","number"]},"distanceMaxAu":{"type":["null","number"]},"distanceMinAu":{"type":["null","number"]},"timeUncertainty":{"type":["null","string"]},"relativeSpeedKmS":{"type":["null","number"]},"absoluteMagnitudeH":{"type":["null","number"]},"estimatedDiameterM":{"type":["null","object"],"properties":{"largest":{"type":["null","number"]},"typical":{"type":["null","number"]},"smallest":{"type":["null","number"]}}}}}},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"designation":{"type":["null","string"]},"nextApproach":{"type":["null","object"],"properties":{"name":{"type":["null","string"]},"distanceAu":{"type":["null","number"]},"distanceKm":{"type":["null","number"]},"approachTdb":{"type":["null","string"]},"daysFromNow":{"type":["null","number"]},"designation":{"type":["null","string"]},"distanceLunar":{"type":["null","number"]},"distanceMaxAu":{"type":["null","number"]},"distanceMinAu":{"type":["null","number"]},"timeUncertainty":{"type":["null","string"]},"relativeSpeedKmS":{"type":["null","number"]},"absoluteMagnitudeH":{"type":["null","number"]},"estimatedDiameterM":{"type":["null","object"],"properties":{"largest":{"type":["null","number"]},"typical":{"type":["null","number"]},"smallest":{"type":["null","number"]}}}}},"totalMatches":{"type":["null","number"]},"maxDistanceLD":{"type":["null","number"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9JFuSAKg0BY-R2JAh60jJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns past and future Earth close-approach events for a specific asteroid or comet by designation, with distances, dates, and uncertainty data.","exampleAgentPrompt":"Can you pull up all close approaches of Apophis (designation 99942) to Earth between 2025 and 2035 that come within 10 lunar distances, and show me the closest one?","exampleUseCases":[{"title":"Tracking Apophis 2029 flyby","prompt":"I've been following the Apophis asteroid — can you look up its close approaches to Earth around 2029, specifically anything within 5 lunar distances, and tell me how close it will actually get in kilometers?"},{"title":"Historical flyby research for Eros","prompt":"I need to research all recorded close approaches of asteroid 433 Eros from 1900 to today — can you fetch up to 50 passes and show me the dates, miss distances, and which one was the closest?"},{"title":"Comet future pass monitoring","prompt":"Can you check when comet 2004 MN4 is expected to pass near Earth in the next 50 years, filtering to approaches within 20 lunar distances, so I can see if there are any notable flybys coming up?"}],"resultDescription":"Returns a list of close-approach events for the specified body, each with approach date (TDB), miss distance in km/lunar distances/AU, distance uncertainty range (min/max AU), days from now, and time uncertainty. Also includes a summary narrative, a verdict on significance, the closest approach record, metadata about data source and freshness, and a degraded flag if data quality is reduced.","failureModes":["Invalid or unrecognized designation returns an error or empty result","Date range too narrow may return zero approaches","maxDistanceLD set too small may return no results for widely-passing bodies","Limit of 1–50 enforced; values outside range rejected","Service unavailable or upstream NASA/JPL data outage returns degraded flag or error"],"whenToPreferThis":"Use this endpoint when you need close-approach history or predictions for a SPECIFIC named asteroid or comet (by designation or number). Prefer it over the general 'upcoming approaches' endpoint when the user cares about one particular body across all time, rather than all bodies in a short window. Best for detailed flyby research, press/public communications about a named object, or planetary defense monitoring of a designated NEO.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:20:46.532Z","isFirstParty":false,"canonicalSlug":"space-objects-body-close-approaches-31f01148"}