Space Events API

The Space Events API provides data on orbital conjunctions, near-Earth object (NEO) close approaches, and astronauts currently in space. All data is cached and refreshed automatically on a configurable schedule.

Conjunctions

Satellite conjunction (close approach) events between tracked objects.

GET /api/events/conjunctions

Response

{
  "conjunctions": [
    {
      "sat1_name": "ISS (ZARYA)",
      "sat1_id": 25544,
      "sat2_name": "CZ-2C DEB",
      "sat2_id": 48721,
      "tca": "2026-02-15T08:30:00Z",
      "min_range_km": 2.5,
      "relative_speed_km_s": 14.2,
      "max_probability": 0.00012
    }
  ],
  "count": 1
}

Conjunction Fields

Field	Type	Description
sat1_name	string	First object name
sat1_id	int|null	First object NORAD ID
sat2_name	string	Second object name
sat2_id	int|null	Second object NORAD ID
tca	string|null	Time of closest approach, ISO 8601
min_range_km	float|null	Minimum distance in km
relative_speed_km_s	float|null	Relative velocity at TCA
max_probability	float|null	Collision probability estimate

---

Near-Earth Objects

Close approach data from NASA’s NEO Feed.

GET /api/events/neos

Response

{
  "neos": [
    {
      "id": "3542519",
      "name": "(2010 PK9)",
      "absolute_magnitude": 26.7,
      "estimated_diameter_min_m": 12.0,
      "estimated_diameter_max_m": 27.0,
      "is_potentially_hazardous": false,
      "close_approach_date": "2026-02-15",
      "relative_velocity_km_s": 8.5,
      "miss_distance_km": 4500000.0,
      "miss_distance_lunar": 11.7
    }
  ],
  "count": 1,
  "hazardous_count": 0
}

NEO Fields

Field	Type	Description
id	string|null	NEO reference ID
name	string	NEO designation
absolute_magnitude	float|null	Absolute magnitude (H)
estimated_diameter_min_m	float|null	Min estimated diameter in meters
estimated_diameter_max_m	float|null	Max estimated diameter in meters
is_potentially_hazardous	bool	PHA classification
close_approach_date	string|null	Date of closest approach
relative_velocity_km_s	float|null	Relative velocity at approach
miss_distance_km	float|null	Miss distance in kilometers
miss_distance_lunar	float|null	Miss distance in lunar distances

Note

The hazardous_count field in the response indicates how many of the returned NEOs are classified as Potentially Hazardous Asteroids (PHAs). PHAs are defined as asteroids with a minimum orbit intersection distance (MOID) of 0.05 AU or less and an absolute magnitude of 22.0 or brighter.

---

Astronauts in Space

List of people currently in space, grouped by spacecraft.

GET /api/events/astronauts

Response

{
  "astronauts": [
    {
      "id": 1234,
      "name": "Matthew Dominick",
      "agency": "NASA",
      "nationality": "American",
      "craft": "ISS",
      "profile_image": "https://...",
      "bio": "Matthew Dominick is a NASA astronaut..."
    }
  ],
  "count": 12,
  "crafts": ["ISS", "Tiangong"]
}

The top-level crafts field lists all spacecraft that currently have crew aboard.

---

Refresh Events

Trigger a manual refresh of all event data (conjunctions, NEOs, astronauts).

POST /api/events/refresh

{
  "status": "refreshing",
  "message": "Events refresh started in background"
}