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/82e754cc-c893-4992-a992-c1b3db972c80/?format=api
{ "id": "82e754cc-c893-4992-a992-c1b3db972c80", "url": "https://ll.thespacedevs.com/2.2.0/launch/82e754cc-c893-4992-a992-c1b3db972c80/?format=api", "slug": "black-brant-ix-deuce", "flightclub_url": null, "r_spacex_api_id": null, "name": "Black Brant IX | DEUCE", "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:05Z", "updates": [ { "id": 2060, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg", "comment": "Launch successful", "info_url": "https://twitter.com/ela_space/status/1546462109403590657", "created_by": "Jay", "created_on": "2022-07-11T12:08:08Z" }, { "id": 2059, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg", "comment": "Liftoff", "info_url": null, "created_by": "Jay", "created_on": "2022-07-11T11:01:34Z" }, { "id": 2058, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg", "comment": "Hold released, new T-0 roughly 11:01 UTC", "info_url": null, "created_by": "Jay", "created_on": "2022-07-11T10:57:16Z" }, { "id": 2057, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg", "comment": "Holding to sync clocks", "info_url": null, "created_by": "Jay", "created_on": "2022-07-11T10:55:31Z" }, { "id": 2056, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/jay2520keegan_profile_20221218022555.jpg", "comment": "Webcast live", "info_url": "https://www.youtube.com/watch?v=l-J5NTUEtJk", "created_by": "Jay", "created_on": "2022-07-11T10:26:39Z" }, { "id": 1961, "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-25T19:05:44Z" } ], "net": "2022-07-11T11:01:00Z", "net_precision": null, "window_end": "2022-07-11T14:45:00Z", "window_start": "2022-07-11T10:57: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": 7612, "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": 6098, "name": "DEUCE", "description": "The Dual-channel Extreme Ultraviolet Continuum Experiment (DEUCE) is a payload from the University of Colorado. its objective is to observe α Centauri A & B and measure a so-far unstudied part of their extreme ultraviolet light spectrum. These measurements are needed to model stars similar to and smaller than our Sun, as well as understand their effects on planetary atmospheres.", "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": "DEUCE will observe α Centauri A and B. DEUCE will measure a so-far unstudied part of their extreme ultraviolet light spectrum. These measurements are needed to model stars similar to and smaller than our Sun, as well as understand their effects on planetary atmospheres.\n\nThe Principal Investigator i...", "feature_image": null, "url": "https://sites.wff.nasa.gov/code810/news/story255-36.350%20DEUCE.html", "type": null, "language": null } ], "vidURLs": [ { "priority": 9, "source": null, "publisher": null, "title": "NASA Launch 3", "description": "NASA’s third space launch from a commercial spaceport for scientific astrophysics missions.", "feature_image": "https://i.ytimg.com/vi/l-J5NTUEtJk/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=l-J5NTUEtJk", "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": 3, "pad_launch_attempt_count": 3, "agency_launch_attempt_count": 3, "orbital_launch_attempt_count_year": 0, "location_launch_attempt_count_year": 3, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 3, "pad_turnaround": "P4DT21H7M", "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" }
