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/2873e5f4-dc84-4de7-a86b-7348143c1772/?format=api
{ "id": "2873e5f4-dc84-4de7-a86b-7348143c1772", "url": "https://ll.thespacedevs.com/2.2.0/launch/2873e5f4-dc84-4de7-a86b-7348143c1772/?format=api", "slug": "pegasus-xl-odyssey-tacrl-2", "flightclub_url": null, "r_spacex_api_id": null, "name": "Pegasus XL | Odyssey (TacRL-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": "2023-06-14T03:55:13Z", "updates": [ { "id": 583, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch success.", "info_url": "https://spaceflightnow.com/2021/06/13/pegasus-rocket-successful-in-responsive-launch-demonstration/", "created_by": "Cosmic_Penguin", "created_on": "2021-06-13T10:28:28Z" }, { "id": 582, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launched", "info_url": "https://twitter.com/SpacecoastPix/status/1403998613764665348", "created_by": "Cosmic_Penguin", "created_on": "2021-06-13T08:55:34Z" }, { "id": 578, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Updating T-0 and setting GO", "info_url": "https://twitter.com/StephenClark1/status/1403054426777174016", "created_by": "Nosu", "created_on": "2021-06-10T18:27:35Z" }, { "id": 577, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "NET June 13 based on navigational warnings", "info_url": "https://twitter.com/Marco_Langbroek/status/1402652658218024961?s=20", "created_by": "Nosu", "created_on": "2021-06-09T19:15:37Z" }, { "id": 574, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adding launch TBD June", "info_url": "https://spaceflightnow.com/launch-schedule/", "created_by": "Nosu", "created_on": "2021-06-08T09:23:22Z" } ], "net": "2021-06-13T08:11:00Z", "net_precision": null, "window_end": "2021-06-13T08:55:00Z", "window_start": "2021-06-13T07:39:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 257, "url": "https://ll.thespacedevs.com/2.2.0/agencies/257/?format=api", "name": "Northrop Grumman Space Systems", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "NGSS", "description": "Northrup Grumman Space Systems designs, builds and delivers space, defence and aviation-related systems to customers around the world. They aquired Orbital ATK in 2018 along with its launchers and ongoing missions.", "administrator": "CEO: Kathy Warden", "founding_year": "2015", "launchers": "Antares | Minotaur | Pegasus", "spacecraft": "Cygnus", "launch_library_url": null, "total_launch_count": 15, "consecutive_successful_launches": 15, "successful_launches": 15, "failed_launches": 0, "pending_launches": 4, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.northropgrumman.com/AboutUs/BusinessSectors/InnovationSystems/Pages/default.aspx", "wiki_url": "https://en.wikipedia.org/wiki/Northrop_Grumman#Innovation_Systems", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/northrop2520grumman2520innovation2520systems_logo_20190207032451.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/northrop2520grumman2520innovation2520systems_image_20190207032451.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/northrop2520grumman2520space2520systems_nation_20230624130158.jpg" }, "rocket": { "id": 2954, "configuration": { "id": 173, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/173/?format=api", "name": "Pegasus XL", "active": true, "reusable": false, "description": "The Pegasus is an air-launched rocket developed by Orbital Sciences Corporation (now part of Northrop Grumman Innovation Systems). Capable of carrying small payloads of up to 443 kilograms (977 lb) into low Earth orbit, the vehicle consists of three solid propellant stages and an optional monopropellant fourth stage. Pegasus is released from its carrier aircraft at approximately 40,000 ft (12,000 m), and its first stage has a wing and a tail to provide lift and attitude control while in the atmosphere.", "family": "Pegasus", "full_name": "Pegasus XL", "manufacturer": { "id": 100, "url": "https://ll.thespacedevs.com/2.2.0/agencies/100/?format=api", "name": "Orbital Sciences Corporation", "featured": false, "type": "Commercial", "country_code": "USA", "abbrev": "OSC", "description": null, "administrator": null, "founding_year": null, "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 72, "consecutive_successful_launches": 0, "successful_launches": 65, "failed_launches": 7, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.orbital.com/", "wiki_url": "http://en.wikipedia.org/wiki/Orbital_Sciences_Corporation", "logo_url": null, "image_url": null, "nation_url": null }, "program": [], "variant": "", "alias": "", "min_stage": 0, "max_stage": 3, "length": 17.6, "diameter": 1.27, "maiden_flight": "1994-06-27", "launch_cost": "40000000", "launch_mass": 23, "leo_capacity": 443, "gto_capacity": 0, "to_thrust": 580, "apogee": 4000, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/pegasus_xl_moun_image_20240307124328.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Pegasus_(rocket)", "total_launch_count": 31, "consecutive_successful_launches": 25, "successful_launches": 28, "failed_launches": 3, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 1375, "name": "Odyssey (TacRL-2)", "description": "Payload for the US Space Force’s Tactically Responsive Launch program. It is a space domain awareness satellite that was procured under the Space Force's responsive launch program. The spacecraft was built in under a year and the launch provider was given three weeks of notice for the launch.", "launch_designator": null, "type": "Government/Top Secret", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 62, "url": "https://ll.thespacedevs.com/2.2.0/pad/62/?format=api", "agency_id": null, "name": "Vandenberg Space Force Base", "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Vandenberg_Space_Force_Base", "map_url": "https://www.google.com/maps?q=34.732778,-120.568056", "latitude": "34.732778", "longitude": "-120.568056", "location": { "id": 20, "url": "https://ll.thespacedevs.com/2.2.0/location/20/?format=api", "name": "Air launch to orbit", "country_code": "???", "description": "", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_20_20200803142433.jpg", "timezone_name": "", "total_launch_count": 51, "total_landing_count": 0 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_62_20200803143441.jpg", "total_launch_count": 22, "orbital_launch_attempt_count": 22 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/pegasus_xl_moun_image_20240307124328.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6091, "location_launch_attempt_count": 47, "pad_launch_attempt_count": 22, "agency_launch_attempt_count": 9, "orbital_launch_attempt_count_year": 54, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 2, "pad_turnaround": "P2907DT5H43M14S", "mission_patches": [], "type": "detailed" }
