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/7533059e-732d-4ee5-9f5d-2974f85b9e88/?format=api
{ "id": "7533059e-732d-4ee5-9f5d-2974f85b9e88", "url": "https://ll.thespacedevs.com/2.2.0/launch/7533059e-732d-4ee5-9f5d-2974f85b9e88/?format=api", "slug": "black-brant-ix-xqc", "flightclub_url": null, "r_spacex_api_id": null, "name": "Black Brant IX | XQC", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2023-06-14T04:31:06Z", "updates": [ { "id": 1976, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Successful launch confirmed", "info_url": "https://www.youtube.com/watch?v=lSfugtxlXmw", "created_by": "Nosu", "created_on": "2022-06-26T14:40:10Z" }, { "id": 1975, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Liftoff", "info_url": "https://www.youtube.com/watch?v=lSfugtxlXmw", "created_by": "Nosu", "created_on": "2022-06-26T14:30:00Z" }, { "id": 1974, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Countdown resumed", "info_url": "https://www.youtube.com/watch?v=lSfugtxlXmw", "created_by": "Nosu", "created_on": "2022-06-26T14:28:34Z" }, { "id": 1973, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Another hold at T-03:00", "info_url": "https://www.youtube.com/watch?v=lSfugtxlXmw", "created_by": "Nosu", "created_on": "2022-06-26T14:06:04Z" }, { "id": 1972, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Countdown resumed", "info_url": "https://www.youtube.com/watch?v=lSfugtxlXmw", "created_by": "Nosu", "created_on": "2022-06-26T14:04:38Z" }, { "id": 1971, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Another hold at T-3 minutes", "info_url": "https://www.youtube.com/watch?v=lSfugtxlXmw", "created_by": "Nosu", "created_on": "2022-06-26T13:58:55Z" }, { "id": 1970, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Countdown resumed", "info_url": "https://www.youtube.com/watch?v=lSfugtxlXmw", "created_by": "Nosu", "created_on": "2022-06-26T13:57:20Z" }, { "id": 1969, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Another hold at T-03:00", "info_url": "https://www.youtube.com/watch?v=lSfugtxlXmw", "created_by": "Nosu", "created_on": "2022-06-26T13:51:53Z" }, { "id": 1968, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Countdown resumed", "info_url": "https://www.youtube.com/watch?v=lSfugtxlXmw", "created_by": "Nosu", "created_on": "2022-06-26T13:51:13Z" }, { "id": 1967, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Hold at T-3 minutes", "info_url": "https://www.youtube.com/watch?v=lSfugtxlXmw", "created_by": "Nosu", "created_on": "2022-06-26T13:45:40Z" }, { "id": 1966, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Delayed by half an hour.", "info_url": "https://www.youtube.com/watch?v=lSfugtxlXmw", "created_by": "Nosu", "created_on": "2022-06-26T12:38:56Z" }, { "id": 1964, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Webcast live", "info_url": "https://www.youtube.com/watch?v=lSfugtxlXmw", "created_by": "Nosu", "created_on": "2022-06-26T12:18:13Z" }, { "id": 1959, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adding launch per request of the Australian Space Agency.", "info_url": "https://ela.space/ela-and-nasa-to-conduct-australias-first-ever-commercial-space-launch/", "created_by": "Nosu", "created_on": "2022-06-25T18:54:07Z" } ], "net": "2022-06-26T14:30:00Z", "net_precision": null, "window_end": "2022-06-26T16:14:00Z", "window_start": "2022-06-26T13:14:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 1038, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1038/?format=api", "name": "Equatorial Launch Australia", "featured": false, "type": "Commercial", "country_code": "AUS", "abbrev": "ELA", "description": "Equatorial Launch Australia (ELA) is an Australian startup founded in 2015 to provide commercial space launches from the Arnhem Land spaceport.", "administrator": "CEO: Michael Jones", "founding_year": "2015", "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 3, "consecutive_successful_launches": 3, "successful_launches": 3, "failed_launches": 0, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://ela.space/", "wiki_url": null, "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/equatorial2520launch2520australia_logo_20220912001304.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/equatorial2520launch2520australia_nation_20220622154855.png" }, "rocket": { "id": 7610, "configuration": { "id": 481, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/481/?format=api", "name": "Black Brant IX", "active": true, "reusable": false, "description": "The Black Brant IX is a Canadian-designed sounding rocket used by the CSA and NASA.", "family": "", "full_name": "Black Brant IX", "manufacturer": { "id": 1039, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1039/?format=api", "name": "Magellan Aerospace Corporation", "featured": false, "type": "Commercial", "country_code": "CAN", "abbrev": "MAC", "description": "Magellan Aerospace Corporation is a Canadian manufacturer of aerospace systems and components.", "administrator": "CEO: Phillip Underwood", "founding_year": "1996", "launchers": "Black Brant", "spacecraft": "", "launch_library_url": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://magellan.aero/", "wiki_url": "https://en.wikipedia.org/wiki/Magellan_Aerospace", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/magellan2520aerospace2520corporation_logo_20220622160105.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/magellan2520aerospace2520corporation_nation_20220622160105.png" }, "program": [], "variant": "IX", "alias": "", "min_stage": 2, "max_stage": 2, "length": 12.2, "diameter": 0.46, "maiden_flight": "1982-03-16", "launch_cost": null, "launch_mass": 2, "leo_capacity": null, "gto_capacity": null, "to_thrust": null, "apogee": 300, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/black_brant_ix_image_20220625190201.jpg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Black_Brant_(rocket)#Black_Brant_IX", "total_launch_count": 3, "consecutive_successful_launches": 3, "successful_launches": 3, "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": 6096, "name": "XQC", "description": "The X-ray Quantum Calorimeter Experiment (XQC) is a payload from the University of Wisconsin. Its objective is to measure X-rays with unprecedented precision to better understand the interstellar medium and its influence on the structure and evolution of galaxies and stars.", "launch_designator": null, "type": "Astrophysics", "orbit": { "id": 15, "name": "Suborbital", "abbrev": "Sub" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 202, "url": "https://ll.thespacedevs.com/2.2.0/pad/202/?format=api", "agency_id": 1038, "name": "Suborbital Launch Ramp", "description": null, "info_url": "https://ela.space/arnhem-space-centre/", "wiki_url": "https://en.wikipedia.org/wiki/Arnhem_Land#Economy", "map_url": "https://www.google.com/maps?q=-12.3892948,136.7903215", "latitude": "-12.3892948", "longitude": "136.7903215", "location": { "id": 160, "url": "https://ll.thespacedevs.com/2.2.0/location/160/?format=api", "name": "Arnhem Space Centre", "country_code": "AUS", "description": "The Arnhem Space Centre was Australia's first commercial spaceport, located near Nhulunbuy, in Arnhem Land, Australia. It was owned and operated by Equatorial Launch Australia (ELA), and was the site of NASA's first non-orbital sounding rocket launch from a commercial port outside the United States on 27 June 2022.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_arnhem_space_centre_20220622160552.jpg", "timezone_name": "Australia/Darwin", "total_launch_count": 3, "total_landing_count": 0 }, "country_code": "AUS", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_suborbital_launch_ramp_20220625184504.jpg", "total_launch_count": 3, "orbital_launch_attempt_count": 0 }, "infoURLs": [ { "priority": 10, "source": null, "title": "NASA Wallops Flight Facility - Sounding Rockets Program Office Code 810", "description": "The night sky glows with X-ray light coming from all directions. Much of this X-ray light is produced by the interstellar medium, which includes hot gases filling the space between the stars. The unique X-ray detectors on this mission, cooled to a frigid one-twentieth of a degree above absolute zero...", "feature_image": null, "url": "https://sites.wff.nasa.gov/code810/news/story254-36.347%20XQC.html", "type": null, "language": null } ], "vidURLs": [ { "priority": 10, "source": null, "publisher": null, "title": "NASA Launch 1", "description": "NASA’s first ever space launch from a commercial spaceport for scientific astrophysics missions. This first of three launches welcomes University of Wisconsi...", "feature_image": "https://i.ytimg.com/vi/lSfugtxlXmw/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=lSfugtxlXmw", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/black_brant_ix_image_20220625190201.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": null, "location_launch_attempt_count": 1, "pad_launch_attempt_count": 1, "agency_launch_attempt_count": 1, "orbital_launch_attempt_count_year": 0, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P0D", "mission_patches": [ { "id": 639, "name": "NASA XQC, SISTINE & DEUCE", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/nasa2520xqc_mission_patch_20220625185212.png", "agency": { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" } } ], "type": "detailed" }
