# Space Objects - Body Close Approaches

> Space Objects - Body Close Approaches is a paid API for AI agents from space-objects.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-21).

Returns past and future Earth close-approach events for a specific asteroid or comet by designation, with distances, dates, and uncertainty data.

## Facts

- Endpoint: GET https://space-objects.x402tookit.com/body-approaches?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/space-objects-body-close-approaches-31f01148
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ow_c22wRAO8CAjAorvxWz

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability space-objects-body-close-approaches-31f01148
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Past and future Earth close approaches of one asteroid or comet by designation, for example Apophis in 2029.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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",
 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/space-objects-body-close-approaches-31f01148/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from space-objects.x402tookit.com](https://www.zero.xyz/host/space-objects.x402tookit.com/llms.txt)