Launch Instance
AN API endpoint that returns all Launch objects or a single launch.
EXAMPLE - /launch/[id]/ or /launch/?mode=list&search=SpaceX
GET Return a list of all Launch objects.
FILTERS Fields - 'name', 'id(s)', 'lsp__id', 'lsp__name', 'serial_number', 'launcher_config__id', 'rocket__spacecraftflight__spacecraft__name', 'is_crewed', 'include_suborbital', 'spacecraft_config__ids', 'related', 'location__ids', 'lsp__ids', 'pad__ids', 'status__ids'
MODE 'normal', 'list', 'detailed'
EXAMPLE ?mode=list
SEARCH Searches through the launch name, rocket name, launch agency, mission name & spacecraft name.
EXAMPLE - ?search=SpaceX
GET /2.2.0/launch/cd199e27-63cd-409c-817c-5c38039b17cd/?format=api
{ "id": "cd199e27-63cd-409c-817c-5c38039b17cd", "url": "https://ll.thespacedevs.com/2.2.0/launch/cd199e27-63cd-409c-817c-5c38039b17cd/?format=api", "slug": "vulcan-vc2s-certification-flight-2", "flightclub_url": "https://flightclub.io/result?llId=cd199e27-63cd-409c-817c-5c38039b17cd", "r_spacex_api_id": null, "name": "Vulcan VC2S | Certification Flight 2", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2024-10-04T17:03:52Z", "updates": [ { "id": 8764, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Launch success", "info_url": "https://x.com/ulalaunch/status/1842192533117702493", "created_by": "SwGustav", "created_on": "2024-10-04T13:33:00Z" }, { "id": 8763, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Liftoff", "info_url": "https://www.youtube.com/watch?v=fAUatH8O6Ng", "created_by": "SwGustav", "created_on": "2024-10-04T11:25:00Z" }, { "id": 8762, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "New T-0", "info_url": "https://x.com/ulalaunch/status/1842157816334762338", "created_by": "SwGustav", "created_on": "2024-10-04T11:02:00Z" }, { "id": 8760, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/lucas2520stauder_profile_20230526163835.jpg", "comment": "HOLD", "info_url": "https://www.youtube.com/watch?v=fAUatH8O6Ng", "created_by": "hitura-nobad", "created_on": "2024-10-04T10:31:00Z" }, { "id": 8759, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/lucas2520stauder_profile_20230526163835.jpg", "comment": "New T-0 10:30 UTC", "info_url": null, "created_by": "hitura-nobad", "created_on": "2024-10-04T10:01:00Z" }, { "id": 8758, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/lucas2520stauder_profile_20230526163835.jpg", "comment": "Weather is 95% GO. Launch on hold.", "info_url": "https://www.youtube.com/watch?v=fAUatH8O6Ng", "created_by": "hitura-nobad", "created_on": "2024-10-04T09:51:00Z" }, { "id": 8757, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/ll2_profile_20230311134739.png", "comment": "Official Webcast by United Launch Alliance has started", "info_url": "https://www.youtube.com/watch?v=fAUatH8O6Ng", "created_by": "LL2", "created_on": "2024-10-04T09:35:00Z" }, { "id": 8754, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Weather 80% GO", "info_url": "https://www.patrick.spaceforce.mil/Portals/14/Weather/Vulcan%20CERT-2%20L-1%20Forecast%20-%204%20Oct%20Launch.pdf", "created_by": "Nosu", "created_on": "2024-10-03T13:24:00Z" }, { "id": 8739, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Weather 75% GO.", "info_url": "https://x.com/SpcPlcyOnline/status/1840875964189872253", "created_by": "Cosmic_Penguin", "created_on": "2024-10-01T00:07:00Z" }, { "id": 8628, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch window.", "info_url": "https://www.ulalaunch.com/missions/next-launch/vulcan-cert-2", "created_by": "Cosmic_Penguin", "created_on": "2024-09-17T22:44:00Z" }, { "id": 8614, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET October 4.", "info_url": "https://x.com/SciGuySpace/status/1835826971525226655", "created_by": "Cosmic_Penguin", "created_on": "2024-09-17T02:45:00Z" }, { "id": 8469, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Targeting end of September.", "info_url": "https://x.com/torybruno/status/1830954392742203504", "created_by": "Cosmic_Penguin", "created_on": "2024-09-03T13:35:48Z" }, { "id": 8112, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET September 16.", "info_url": "https://arstechnica.com/space/2024/07/a-mid-september-test-flight-of-vulcan-could-permit-a-military-launch-this-year/", "created_by": "Cosmic_Penguin", "created_on": "2024-07-24T01:46:20Z" }, { "id": 7963, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Updated launch vehicle configuration.", "info_url": "https://x.com/torybruno/status/1801976218427756771", "created_by": "Cosmic_Penguin", "created_on": "2024-06-27T18:44:58Z" }, { "id": 7955, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch as replacement for Vulcan USSF certification usage after original payload was delayed.", "info_url": "https://x.com/ulalaunch/status/1805994649967857981", "created_by": "Cosmic_Penguin", "created_on": "2024-06-26T16:13:43Z" } ], "net": "2024-10-04T11:25:00Z", "net_precision": { "id": 0, "name": "Second", "abbrev": "SEC", "description": "The T-0 is accurate to the second." }, "window_end": "2024-10-04T13:00:00Z", "window_start": "2024-10-04T10:00:00Z", "probability": 95, "weather_concerns": "None", "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 124, "url": "https://ll.thespacedevs.com/2.2.0/agencies/124/?format=api", "name": "United Launch Alliance", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "ULA", "description": "United Launch Alliance (ULA) is a joint venture of Lockheed Martin Space Systems and Boeing Defense, Space & Security. ULA was formed in December 2006 by combining the teams at these companies which provide spacecraft launch services to the government of the United States. ULA launches from both coasts of the US. They launch their Atlas V vehicle from LC-41 in Cape Canaveral and LC-3E at Vandeberg. Their Delta IV launches from LC-37 at Cape Canaveral and LC-6 at Vandenberg.", "administrator": "CEO: Tory Bruno", "founding_year": "2006", "launchers": "Atlas | Delta IV | Vulcan", "spacecraft": "CST-100 Starliner", "launch_library_url": null, "total_launch_count": 165, "consecutive_successful_launches": 165, "successful_launches": 165, "failed_launches": 0, "pending_launches": 44, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.ulalaunch.com/", "wiki_url": "http://en.wikipedia.org/wiki/United_Launch_Alliance", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_logo_20210412195953.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united_launch_a_image_20210412201210.png", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_nation_20230531043703.jpg" }, "rocket": { "id": 8277, "configuration": { "id": 201, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/201/?format=api", "name": "Vulcan VC2S", "active": true, "reusable": false, "description": "Vulcan Centaur is a two-stage-to-orbit, heavy-lift launch vehicle under development by United Launch Alliance (ULA) since 2014. It is principally designed to meet launch demands for the U.S. government's National Security Space Launch (NSSL) program for use by the United States Space Force and U.S. intelligence agencies for national security satellite launches. It will replace both of ULA's existing launchers (Atlas V and Delta IV Heavy) in this role, as these launchers are retiring.", "family": "Vulcan", "full_name": "Vulcan VC2S", "manufacturer": { "id": 124, "url": "https://ll.thespacedevs.com/2.2.0/agencies/124/?format=api", "name": "United Launch Alliance", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "ULA", "description": "United Launch Alliance (ULA) is a joint venture of Lockheed Martin Space Systems and Boeing Defense, Space & Security. ULA was formed in December 2006 by combining the teams at these companies which provide spacecraft launch services to the government of the United States. ULA launches from both coasts of the US. They launch their Atlas V vehicle from LC-41 in Cape Canaveral and LC-3E at Vandeberg. Their Delta IV launches from LC-37 at Cape Canaveral and LC-6 at Vandenberg.", "administrator": "CEO: Tory Bruno", "founding_year": "2006", "launchers": "Atlas | Delta IV | Vulcan", "spacecraft": "CST-100 Starliner", "launch_library_url": null, "total_launch_count": 165, "consecutive_successful_launches": 165, "successful_launches": 165, "failed_launches": 0, "pending_launches": 44, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.ulalaunch.com/", "wiki_url": "http://en.wikipedia.org/wiki/United_Launch_Alliance", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_logo_20210412195953.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united_launch_a_image_20210412201210.png", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_nation_20230531043703.jpg" }, "program": [], "variant": "VC2S", "alias": "", "min_stage": 2, "max_stage": 2, "length": 61.6, "diameter": 5.4, "maiden_flight": "2024-01-08", "launch_cost": null, "launch_mass": 663, "leo_capacity": 19000, "gto_capacity": 8400, "to_thrust": 9303, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vulcan_image_20240107162928.jpeg", "info_url": "https://www.ulalaunch.com/rockets/vulcan-centaur", "wiki_url": "https://en.wikipedia.org/wiki/Vulcan_Centaur", "total_launch_count": 2, "consecutive_successful_launches": 2, "successful_launches": 2, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 6858, "name": "Certification Flight 2", "description": "Replacement Vulcan test launch with inert payload, experiments, and demonstrations for certification with the USSF after delays caused by payload testing of the Sierra Space Dreamchaser CRS SNC-1 mission, the original planned payload.\r\n\r\nOne of the GEM-63XL SRBs was observed to blown out its booster nozzle at T+37 seconds, causing reduced and asymmetric thrust during ascent, however the performance shortfall was fully compensated by Vulcan's other stages.", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 6, "name": "Heliocentric N/A", "abbrev": "Helio-N/A" }, "agencies": [ { "id": 124, "url": "https://ll.thespacedevs.com/2.2.0/agencies/124/?format=api", "name": "United Launch Alliance", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "ULA", "description": "United Launch Alliance (ULA) is a joint venture of Lockheed Martin Space Systems and Boeing Defense, Space & Security. ULA was formed in December 2006 by combining the teams at these companies which provide spacecraft launch services to the government of the United States. ULA launches from both coasts of the US. They launch their Atlas V vehicle from LC-41 in Cape Canaveral and LC-3E at Vandeberg. Their Delta IV launches from LC-37 at Cape Canaveral and LC-6 at Vandenberg.", "administrator": "CEO: Tory Bruno", "founding_year": "2006", "launchers": "Atlas | Delta IV | Vulcan", "spacecraft": "CST-100 Starliner", "launch_library_url": null, "total_launch_count": 165, "consecutive_successful_launches": 165, "successful_launches": 165, "failed_launches": 0, "pending_launches": 44, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.ulalaunch.com/", "wiki_url": "http://en.wikipedia.org/wiki/United_Launch_Alliance", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_logo_20210412195953.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united_launch_a_image_20210412201210.png", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_nation_20230531043703.jpg" } ], "info_urls": [], "vid_urls": [] }, "pad": { "id": 29, "url": "https://ll.thespacedevs.com/2.2.0/pad/29/?format=api", "agency_id": null, "name": "Space Launch Complex 41", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Air_Force_Station_Space_Launch_Complex_41", "map_url": "https://www.google.com/maps?q=28.58341025,-80.58303644", "latitude": "28.58341025", "longitude": "-80.58303644", "location": { "id": 12, "url": "https://ll.thespacedevs.com/2.2.0/location/12/?format=api", "name": "Cape Canaveral SFS, FL, USA", "country_code": "USA", "description": "Cape Canaveral Space Force Station (CCSFS) is an installation of the United States Space Force's Space Launch Delta 45, located on Cape Canaveral in Brevard County, Florida.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg", "timezone_name": "America/New_York", "total_launch_count": 1023, "total_landing_count": 64 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_29_20200803143528.jpg", "total_launch_count": 115, "orbital_launch_attempt_count": 115 }, "infoURLs": [ { "priority": 10, "source": "www.ulalaunch.com", "title": "Vulcan Cert-2", "description": "A United Launch Alliance (ULA) Vulcan VC2S rocket will launch the second certification (Cert-2) mission from Space Launch Complex-41 at Cape Canaveral Space Force Station, Florida. The Cert-2 mission includes an inert payload and demonstrations associated with future Centaur V technologies. This is ...", "feature_image": null, "url": "https://www.ulalaunch.com/missions/next-launch/vulcan-cert-2", "type": { "id": 1, "name": "Official Page" }, "language": { "id": 1, "name": "English", "code": "en" } } ], "vidURLs": [ { "priority": 10, "source": "youtube.com", "publisher": "United Launch Alliance", "title": "Oct. 4 LIVE Broadcast: Vulcan Cert-2", "description": "A United Launch Alliance (ULA) Vulcan VC2S rocket will launch the second certification (Cert-2) mission from Space Launch Complex-41 at Cape Canaveral Space Force Station, Florida. The Cert-2 mission ...", "feature_image": "https://i.ytimg.com/vi/fAUatH8O6Ng/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=fAUatH8O6Ng", "type": { "id": 1, "name": "Official Webcast" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2024-10-04T09:35:21Z", "end_time": "2024-10-04T12:12:59Z" } ], "webcast_live": false, "timeline": [ { "type": { "id": 9, "abbrev": "Ignition", "description": "Start of the engine ignition sequence" }, "relative_time": "-PT4.9S" }, { "type": { "id": 10, "abbrev": "Liftoff", "description": "First upwards movement of the rocket" }, "relative_time": "PT1.1S" }, { "type": { "id": 25, "abbrev": "Supersonic", "description": "Vehicle is supersonic" }, "relative_time": "PT1M9.9S" }, { "type": { "id": 11, "abbrev": "Max-Q", "description": "Maximum dynamic pressure" }, "relative_time": "PT1M16.1S" }, { "type": { "id": 77, "abbrev": "SRB Separation", "description": "The solid rocket boosters are separated from the launcher." }, "relative_time": "PT1M48.8S" }, { "type": { "id": 12, "abbrev": "MECO", "description": "Cut-off of the main engine" }, "relative_time": "PT4M59.1S" }, { "type": { "id": 13, "abbrev": "Stage 2 Separation", "description": "Separation of the second stage from the first" }, "relative_time": "PT5M5.1S" }, { "type": { "id": 14, "abbrev": "SES-1", "description": "First start of the second engine" }, "relative_time": "PT5M15.1S" }, { "type": { "id": 15, "abbrev": "Fairing Separation", "description": "Separation of the payload fairing" }, "relative_time": "PT5M23.1S" }, { "type": { "id": 20, "abbrev": "SECO-1", "description": "First cut-off of the second engine" }, "relative_time": "PT15M55.7S" }, { "type": { "id": 21, "abbrev": "SES-2", "description": "Second start of the second engine" }, "relative_time": "PT30M53.6S" }, { "type": { "id": 22, "abbrev": "SECO-2", "description": "Second cut-off of the second engine" }, "relative_time": "PT34M54.6S" } ], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vulcan_image_20240107162928.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6772, "location_launch_attempt_count": 977, "pad_launch_attempt_count": 114, "agency_launch_attempt_count": 164, "orbital_launch_attempt_count_year": 183, "location_launch_attempt_count_year": 50, "pad_launch_attempt_count_year": 4, "agency_launch_attempt_count_year": 5, "pad_turnaround": "P66DT40M", "mission_patches": [], "type": "detailed" }
