SpaceX REST API

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

Documentation

• See the Docs for full 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",
  "tbd": false,
  "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": "https://www.reddit.com/r/spacex/comments/9xmpa7/eshail_2_recovery_thread/",
    "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 was its first for Es'hailSat. Es'hail-2 is a communications satellite delivering television and internet to Qatar and the surrounding region. It was launched into a geostationary transfer orbit from LC-39A at Kennedy Space Center. The booster landed 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

V2 - Deprecated

• 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