API Documentation

Integrate RocketWatch data into your systems

Quick Start

Access RocketWatch data through our REST API. All endpoints return JSON with the standard response format.

GET /api/launches
Content-Type: application/json

// Response
{ "ok": true, "data": [...] }

REST API

Standard REST endpoints with JSON responses

Authenticated

Session-based authentication required

Real-time

Live telemetry data during active missions

Endpoints

GET/api/rockets

Retrieve all tracked rockets with specifications

View Response Example

{
  "ok": true,
  "data": [{
    "_id": "abc123",
    "name": "Falcon Heavy",
    "manufacturer": "SpaceX",
    "rocket_type": "heavy_lift",
    "height_meters": 70,
    "thrust_kn": 22819,
    "success_rate": 100,
    "status": "active"
  }]
}

GET/api/launches

Retrieve all launch events with rocket data and counts

View Response Example

{
  "ok": true,
  "data": [{
    "_id": "def456",
    "mission_name": "Starlink Group 12-1",
    "rocket": { "name": "Falcon Heavy", ... },
    "status": "success",
    "max_altitude_km": 550,
    "max_velocity_kmh": 27000
  }]
}

GET/api/launches/:id

Retrieve a specific launch with telemetry and alerts

View Response Example

{
  "ok": true,
  "data": [{
    "_id": "def456",
    "mission_name": "Starlink Group 12-1",
    "rocket": { ... },
    "tracking_data": [{ "altitude_km": 12, ... }],
    "launch_alert": [{ "title": "Liftoff", ... }]
  }]
}

GET/api/alerts

Retrieve all launch alerts sorted by timestamp

View Response Example

{
  "ok": true,
  "data": [{
    "_id": "ghi789",
    "title": "Launch Success",
    "severity": "success",
    "alert_type": "mission_complete",
    "launch_event": { "mission_name": "..." }
  }]
}

GET/api/tracking/:launchId

Retrieve telemetry data points for a specific launch

View Response Example

{
  "ok": true,
  "data": [{
    "altitude_km": 180,
    "velocity_kmh": 14200,
    "acceleration_g": 2.8,
    "stage": "Stage 2 - Coast",
    "fuel_remaining_pct": 65
  }]
}

GET/api/stats

Retrieve dashboard statistics and aggregations

View Response Example

{
  "ok": true,
  "data": {
    "total_rockets": 5,
    "total_launches": 6,
    "active_missions": 1,
    "success_rate": 80,
    "launches_by_status": [...]
  }
}

Rate Limits & Pricing

Plan	Requests/min	Launches/mo	Telemetry Access
Starter	60	10	Basic
Professional	300	50	Full
Enterprise	Unlimited	Unlimited	Premium