SpaceX REST API

Open Source REST API for rocket, core, capsule, pad, and launch data

Documentation

• See the Docs for full V3 API Documentation

Postman Collection

Usage

Example Response

curl -s https://api.spacexdata.com/v3/launches/latest | jq

{
  "flight_number": 70,
  "mission_name": "Es’hail 2",
  "mission_id": [],
  "launch_year": "2018",
  "launch_date_unix": 1542314760,
  "launch_date_utc": "2018-11-15T20:46:00.000Z",
  "launch_date_local": "2018-11-15T15:46:00-05:00",
  "is_tentative": false,
  "tentative_max_precision": "hour",
  "rocket": {
    "rocket_id": "falcon9",
    "rocket_name": "Falcon 9",
    "rocket_type": "FT",
    "first_stage": {
      "cores": [
        {
          "core_serial": "B1047",
          "flight": 2,
          "block": 5,
          "gridfins": true,
          "legs": true,
          "reused": true,
          "land_success": true,
          "landing_intent": true,
          "landing_type": "ASDS",
          "landing_vehicle": "OCISLY"
        }
      ]
    },
    "second_stage": {
      "block": 5,
      "payloads": [
        {
          "payload_id": "Es’hail 2",
          "norad_id": [
            43700
          ],
          "reused": false,
          "customers": [
            "Es’hailSat"
          ],
          "nationality": "Qatar",
          "manufacturer": "Mitsubishi Electric",
          "payload_type": "Satellite",
          "payload_mass_kg": 3000,
          "payload_mass_lbs": 6613.868,
          "orbit": "GTO",
          "orbit_params": {
            "reference_system": "geocentric",
            "regime": "geostationary",
            "longitude": 25.5,
            "semi_major_axis_km": 25322.941,
            "eccentricity": 0.7401796,
            "periapsis_km": 201.281,
            "apoapsis_km": 37688.33,
            "inclination_deg": 25.0155,
            "period_min": 668.391,
            "lifespan_years": 15,
            "epoch": "2018-11-15T22:50:01.000Z",
            "mean_motion": 2.1544258,
            "raan": 199.6281,
            "arg_of_pericenter": 178.1843,
            "mean_anomaly": 52.4356
          }
        }
      ]
    },
    "fairings": {
      "reused": false,
      "recovery_attempt": false,
      "recovered": false,
      "ship": null
    }
  },
  "ships": [
    "HAWK",
    "OCISLY"
  ],
  "telemetry": {
    "flight_club": "https://www.flightclub.io/result/2d?code=ESL2"
  },
  "launch_site": {
    "site_id": "ksc_lc_39a",
    "site_name": "KSC LC 39A",
    "site_name_long": "Kennedy Space Center Historic Launch Complex 39A"
  },
  "launch_success": true,
  "links": {
    "mission_patch": "https://images2.imgbox.com/59/c8/HPYpMlux_o.png",
    "mission_patch_small": "https://images2.imgbox.com/a3/96/WvJsBXuE_o.png",
    "reddit_campaign": "https://www.reddit.com/r/spacex/comments/9p82jt/eshail_2_launch_campaign_thread/",
    "reddit_launch": "https://www.reddit.com/r/spacex/comments/9x9w9v/rspacex_eshail_2_official_launch_discussion/",
    "reddit_recovery": null,
    "reddit_media": "https://www.reddit.com/r/spacex/comments/9xaa76/rspacex_eshail_2_media_thread_videos_images_gifs/",
    "presskit": "https://www.spacex.com/sites/spacex/files/eshail-2_mission_press_kit_11_14_2018.pdf",
    "article_link": "https://spaceflightnow.com/2018/11/15/spacex-launches-qatars-eshail-2-communications-satellite/",
    "wikipedia": "https://en.wikipedia.org/wiki/Es%27hailSat",
    "video_link": "https://www.youtube.com/watch?v=PhTbzc-BqKs&feature=youtu.be",
    "flickr_images": [
      "https://farm5.staticflickr.com/4834/32040174268_b71d703417_o.jpg",
      "https://farm5.staticflickr.com/4810/32040174058_a65fa64e85_o.jpg",
      "https://farm5.staticflickr.com/4814/32040173268_0ab571e7bc_o.jpg",
      "https://farm5.staticflickr.com/4899/32040173568_bb5c991565_o.jpg",
      "https://farm5.staticflickr.com/4875/32040173278_b5578ba6be_o.jpg",
      "https://farm5.staticflickr.com/4862/32040173928_afdfb09939_o.jpg",
      "https://farm5.staticflickr.com/4888/32040173048_b2b29c020f_o.jpg"
    ]
  },
  "details": "SpaceX's eighteenth flight of 2018 will be its first for Es'hailSat. Es'hail-2 is a communications satellite that will deliver television and internet to Qatar and the surrounding region. It will be launched into a geostationary transfer orbit from LC-39A at Kennedy Space Center. The booster is expected to land on OCISLY.",
  "upcoming": false,
  "static_fire_date_utc": "2018-11-12T18:13:00.000Z",
  "static_fire_date_unix": 1542046380
}

Community made UI Clients / API Clients / API wrappers

See clients

API Status

See the status page for more details

Contributions

See the contribution guide for detailed steps

Local Development

Local development info can be found here

Old V2 docs

• API V2 will be available indefinitely, but will no longer receive new feature updates.
• V2 data will still be updated
• V2 docs will no longer be updated
• Old V2 docs located here

Technical Details

• Deployed on a central U.S. Linode server
• Using Node.js with the Koa framework
• Using Redis, Nginx, and Cloudflare for content caching
• Using Jest and Supertest for tests
• Using Circle CI for continuous integration / deployments
• All data stored in a MongoDB Atlas 3 node replica set cluster
• Latest database mongodump and zipped JSON files available here

FAQ's

• If you have any questions or corrections, please open an issue and we'll get it merged ASAP
• All data and photos are property of Space Exploration Technologies Corporation (SpaceX)
• I am not affiliated with SpaceX in any way, shape, form, or fashion. Just a fun side project for me
• For any other questions or concerns, just shoot me an email

License