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/8cfa00a5-a72e-48b7-80bd-944664688f59/?format=api
{ "id": "8cfa00a5-a72e-48b7-80bd-944664688f59", "url": "https://ll.thespacedevs.com/2.2.0/launch/8cfa00a5-a72e-48b7-80bd-944664688f59/?format=api", "slug": "delta-iv-heavy-nrol-68", "flightclub_url": "https://flightclub.io/result?llId=8cfa00a5-a72e-48b7-80bd-944664688f59", "r_spacex_api_id": null, "name": "Delta IV Heavy | NROL-68", "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-03-05T18:09:57Z", "updates": [ { "id": 4459, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch success.", "info_url": "https://twitter.com/ulalaunch/status/1671907482145558529", "created_by": "Cosmic_Penguin", "created_on": "2023-06-22T15:47:31Z" }, { "id": 4456, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Liftoff.", "info_url": "https://www.youtube.com/watch?v=qNLo5QbVhVM", "created_by": "Cosmic_Penguin", "created_on": "2023-06-22T09:18:19Z" }, { "id": 4455, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/ll2_profile_20230311134739.png", "comment": "Livestream has started", "info_url": "https://www.youtube.com/watch?v=qNLo5QbVhVM", "created_by": "LL2", "created_on": "2023-06-22T08:54:18Z" }, { "id": 4451, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Updated weather.", "info_url": "https://twitter.com/ulalaunch/status/1671772751453986816", "created_by": "Cosmic_Penguin", "created_on": "2023-06-22T06:51:40Z" }, { "id": 4443, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "New T-0.", "info_url": "https://twitter.com/ulalaunch/status/1671754177872027649", "created_by": "Cosmic_Penguin", "created_on": "2023-06-22T05:38:36Z" }, { "id": 4442, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "New T-0.", "info_url": "https://twitter.com/ulalaunch/status/1671738354742747138", "created_by": "Cosmic_Penguin", "created_on": "2023-06-22T05:11:42Z" }, { "id": 4433, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Scrubbed for the day, 24 hours recycle.", "info_url": "https://twitter.com/ulalaunch/status/1671392364542451712", "created_by": "Cosmic_Penguin", "created_on": "2023-06-21T05:40:42Z" }, { "id": 4432, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Countdown in unplanned hold while pre-launch checks continue.", "info_url": "https://www.ulalaunch.com/missions/next-launch/delta-iv-heavy-nrol-68", "created_by": "Cosmic_Penguin", "created_on": "2023-06-21T05:25:13Z" }, { "id": 4431, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "New T-0.", "info_url": "https://www.ulalaunch.com/missions/next-launch/delta-iv-heavy-nrol-68", "created_by": "Cosmic_Penguin", "created_on": "2023-06-21T03:34:29Z" }, { "id": 4417, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Updated weather forecast.", "info_url": "https://twitter.com/ulalaunch/status/1670433817604005889", "created_by": "Cosmic_Penguin", "created_on": "2023-06-18T14:30:39Z" }, { "id": 4348, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Updated T-0.", "info_url": "https://twitter.com/natreconofc/status/1669031471061901339", "created_by": "Cosmic_Penguin", "created_on": "2023-06-14T17:22:41Z" }, { "id": 4210, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Reverted launch time estimates; apparently was in error.", "info_url": "https://twitter.com/stephenclark1/status/1662505633453580288", "created_by": "Cosmic_Penguin", "created_on": "2023-05-28T11:48:38Z" }, { "id": 4174, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch time.", "info_url": "https://spaceflightnow.com/launch-schedule/", "created_by": "Cosmic_Penguin", "created_on": "2023-05-27T06:40:43Z" }, { "id": 4105, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET June 21.", "info_url": "https://twitter.com/natreconofc/status/1661067120938041372", "created_by": "Cosmic_Penguin", "created_on": "2023-05-23T17:53:47Z" }, { "id": 3870, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET May 2023", "info_url": "https://spaceflightnow.com/launch-schedule/", "created_by": "Cosmic_Penguin", "created_on": "2023-04-25T07:47:04Z" }, { "id": 3762, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Delayed due to valve issue.", "info_url": "https://twitter.com/ulalaunch/status/1644022444745969664", "created_by": "Cosmic_Penguin", "created_on": "2023-04-06T17:02:11Z" }, { "id": 3624, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "NET April 20", "info_url": "https://twitter.com/natreconofc/status/1638274303937466374", "created_by": "Nosu", "created_on": "2023-03-21T20:26:09Z" }, { "id": 3551, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "NET April", "info_url": "https://spaceflightnow.com/launch-schedule/", "created_by": "Nosu", "created_on": "2023-03-14T14:59:31Z" }, { "id": 3517, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET 1H 2023", "info_url": "https://www.launchphotography.com/Launch_Viewing_Guide.html", "created_by": "Cosmic_Penguin", "created_on": "2023-03-11T19:55:53Z" }, { "id": 2695, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "NET March", "info_url": "https://spaceflightnow.com/launch-schedule/", "created_by": "Nosu", "created_on": "2022-10-27T04:27:03Z" }, { "id": 4406, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Weather 70%", "info_url": "https://www.patrick.spaceforce.mil/Portals/14/Weather/Delta%20IV%20Heavy%20L-68%20L-4%20Forecast%20-%2021%20Jun%20Launch.pdf", "created_by": "Nosu", "created_on": "2023-06-17T15:21:30Z" }, { "id": 4301, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch window.", "info_url": "https://twitter.com/NatReconOfc/status/1666542065767907333", "created_by": "Cosmic_Penguin", "created_on": "2023-06-07T22:46:13Z" } ], "net": "2023-06-22T09:18:00Z", "net_precision": { "id": 1, "name": "Minute", "abbrev": "MIN", "description": "The T-0 is accurate to the minute." }, "window_end": "2023-06-22T11:45:00Z", "window_start": "2023-06-22T07:00:00Z", "probability": 90, "weather_concerns": "Anvil Cloud Rules, Ground Winds", "holdreason": "", "failreason": "", "hashtag": "#NROL68", "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": 2533, "configuration": { "id": 21, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/21/?format=api", "name": "Delta IV Heavy", "active": false, "reusable": false, "description": "The Delta IV Heavy (Delta 9250H) is an expendable heavy-lift launch vehicle, the largest type of the Delta IV family, and is the world's second highest-capacity rocket in operation. It is manufactured by United Launch Alliance and was first launched in 2004.", "family": "Delta", "full_name": "Delta IV Heavy", "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": "Heavy", "alias": "", "min_stage": 2, "max_stage": 2, "length": 72.0, "diameter": 5.0, "maiden_flight": "2004-12-21", "launch_cost": "350000000", "launch_mass": 733, "leo_capacity": 28370, "gto_capacity": 14210, "to_thrust": 8674, "apogee": 40000, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/delta_iv_heavy_image_20210426103838.jpg", "info_url": "https://www.ulalaunch.com/rockets/delta-iv", "wiki_url": "https://en.wikipedia.org/wiki/Delta_IV_Heavy", "total_launch_count": 16, "consecutive_successful_launches": 15, "successful_launches": 15, "failed_launches": 1, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 6167, "name": "NROL-68", "description": "Classified payload for the National Reconnaissance Office.", "launch_designator": null, "type": "Government/Top Secret", "orbit": { "id": 1, "name": "Geostationary Orbit", "abbrev": "Direct-GEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 38, "url": "https://ll.thespacedevs.com/2.2.0/pad/38/?format=api", "agency_id": null, "name": "Space Launch Complex 37B", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Air_Force_Station_Space_Launch_Complex_37", "map_url": "https://www.google.com/maps?q=28.5317,-80.56495", "latitude": "28.5317", "longitude": "-80.56495", "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_38_20200803143515.jpg", "total_launch_count": 40, "orbital_launch_attempt_count": 40 }, "infoURLs": [ { "priority": 10, "source": null, "title": "404 - File or directory not found.", "description": "The resource you are looking for might have been removed, had its name changed, or is temporarily unavailable.", "feature_image": null, "url": "https://www.ulalaunch.com/missions/next-launch/delta-iv-heavy-nrol-68", "type": null, "language": null } ], "vidURLs": [ { "priority": 10, "source": null, "publisher": null, "title": "June 21 Live Broadcast: Delta IV Heavy NROL-68", "description": "A United Launch Alliance (ULA) Delta IV Heavy rocket is launching the NROL-68 mission for the National Reconnaissance Office (NRO). Liftoff will occur from S...", "feature_image": "https://i.ytimg.com/vi/qNLo5QbVhVM/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=qNLo5QbVhVM", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/delta2520iv25_image_20230622183505.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6463, "location_launch_attempt_count": 892, "pad_launch_attempt_count": 39, "agency_launch_attempt_count": 157, "orbital_launch_attempt_count_year": 95, "location_launch_attempt_count_year": 24, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P923DT8H9M", "mission_patches": [ { "id": 784, "name": "NROL-68 Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/nrol-682520pat_mission_patch_20230615072438.png", "agency": { "id": 181, "url": "https://ll.thespacedevs.com/2.2.0/agencies/181/?format=api", "name": "National Reconnaissance Office", "type": "Government" } } ], "type": "detailed" }
