Launches & Reentry API

The Launches and Reentry APIs provide data on rocket launches (sourced from Launch Library 2) and orbital decay predictions (sourced from Space-Track TIP messages). Both datasets are refreshed automatically on a configurable schedule.

Launches

List Launches

GET /api/launches

Query Parameters

Parameter	Type	Default	Description
`upcoming`	`bool`	—	Filter: `true` for upcoming, `false` for past
`limit`	`int`	`20`	Max results

Response

{
  "launches": [
    {
      "id": 42,
      "ll2_id": "abc123",
      "name": "Falcon 9 Block 5 | Starlink Group 12-1",
      "status_name": "Go for Launch",
      "status_abbrev": "Go",
      "net": "2026-02-15T14:30:00Z",
      "window_start": "2026-02-15T14:30:00Z",
      "window_end": "2026-02-15T18:30:00Z",
      "provider_name": "SpaceX",
      "rocket_name": "Falcon 9 Block 5",
      "pad_name": "SLC-40, Cape Canaveral SFS",
      "pad_lat": 28.5618,
      "pad_lon": -80.5771,
      "mission_name": "Starlink Group 12-1",
      "mission_type": "Communications",
      "mission_orbit": "Low Earth Orbit",
      "mission_description": "A batch of satellites for the Starlink mega-constellation...",
      "image_url": "https://...",
      "webcast_url": "https://...",
      "info_url": "https://...",
      "ll2_url": "https://...",
      "is_upcoming": true
    }
  ],
  "count": 1
}

Examples

# Upcoming launches
curl "https://space.warehack.ing/api/launches?upcoming=true&limit=5"

# Past launches
curl "https://space.warehack.ing/api/launches?upcoming=false&limit=10"

Next Launch

Get the single next upcoming launch.

GET /api/launches/next

Response

{
  "name": "Falcon 9 Block 5 | Starlink Group 12-1",
  "net": "2026-02-15T14:30:00Z",
  "provider_name": "SpaceX",
  "rocket_name": "Falcon 9 Block 5",
  "pad_name": "SLC-40, Cape Canaveral SFS",
  "status_name": "Go for Launch",
  "status_abbrev": "Go"
}

Status	Description
`404`	No upcoming launches found

Get Launch Detail

GET /api/launches/{launch_id}

Returns the full launch object (same shape as the list items above).

Status	Description
`404`	Launch not found

Refresh Launches

Trigger a manual refresh of launch data from Launch Library 2.

POST /api/launches/refresh

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

Reentry Predictions

Reentry predictions track objects expected to deorbit, sourced from Space-Track TIP (Tracking and Impact Prediction) messages.

List Predictions

GET /api/reentry

Query Parameters

Parameter	Type	Default	Description
`limit`	`int`	`50`	Max results (1-200)
`source`	`string`	—	Filter by source (e.g. `spacetrack`)

Response

{
  "predictions": [
    {
      "id": 1,
      "norad_id": 58234,
      "object_name": "CZ-2C R/B",
      "intl_designator": "2023-156B",
      "country": "PRC",
      "msg_epoch": "2026-02-14T08:00:00Z",
      "decay_epoch": "2026-02-16T12:00:00Z",
      "source": "spacetrack",
      "tip_class": "high_interest",
      "lat": null,
      "lon": null,
      "object_type": "ROCKET BODY",
      "rcs": 8.5
    }
  ],
  "count": 1
}

Reentry Alerts

Get objects predicted to reenter within the next 48 hours, sorted by soonest first.

GET /api/reentry/alerts

Response

[
  {
    "norad_id": 58234,
    "object_name": "CZ-2C R/B",
    "decay_epoch": "2026-02-16T12:00:00Z",
    "hours_remaining": 37.5,
    "source": "spacetrack",
    "object_type": "ROCKET BODY"
  }
]

Refresh Reentry Data

POST /api/reentry/refresh

{
  "status": "ok",
  "message": "Reentry refresh started"
}