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/8baac795-3f94-4639-be39-29eb977af2b5/?format=api
{ "id": "8baac795-3f94-4639-be39-29eb977af2b5", "url": "https://ll.thespacedevs.com/2.2.0/launch/8baac795-3f94-4639-be39-29eb977af2b5/?format=api", "slug": "orion-test-booster-ascent-abort-2", "flightclub_url": null, "r_spacex_api_id": null, "name": "Orion Test Booster | Ascent Abort-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-01-08T08:39:40Z", "updates": [], "net": "2019-07-02T11:00:00Z", "net_precision": null, "window_end": "2019-07-02T11:00:00Z", "window_start": "2019-07-02T11:00:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "featured": true, "type": "Government", "country_code": "USA", "abbrev": "NASA", "description": "The National Aeronautics and Space Administration is an independent agency of the executive branch of the United States federal government responsible for the civilian space program, as well as aeronautics and aerospace research. NASA have many launch facilities but most are inactive. The most commonly used pad will be LC-39B at Kennedy Space Center in Florida.", "administrator": "Acting Administrator: James Free", "founding_year": "1958", "launchers": "Space Shuttle | SLS", "spacecraft": "Orion", "launch_library_url": null, "total_launch_count": 141, "consecutive_successful_launches": 11, "successful_launches": 121, "failed_launches": 20, "pending_launches": 6, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.nasa.gov", "wiki_url": "http://en.wikipedia.org/wiki/National_Aeronautics_and_Space_Administration", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_logo_20190207032448.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_image_20190207032448.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_nation_20230803040809.jpg" }, "rocket": { "id": 2486, "configuration": { "id": 195, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/195/?format=api", "name": "Orion Abort Test Booster", "active": false, "reusable": false, "description": "The Orion Abort Test Booster is a small solid rocket launcher developed by Northropp Grumman.\r\n\r\nIt uses a single stage Peacekeeper missile first stage motor [SR118] inside an Aero-Shell to replicate the Orion Service Module 5.5 meter diameter.", "family": "", "full_name": "Orion Abort Test Booster", "manufacturer": { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "featured": true, "type": "Government", "country_code": "USA", "abbrev": "NASA", "description": "The National Aeronautics and Space Administration is an independent agency of the executive branch of the United States federal government responsible for the civilian space program, as well as aeronautics and aerospace research. NASA have many launch facilities but most are inactive. The most commonly used pad will be LC-39B at Kennedy Space Center in Florida.", "administrator": "Acting Administrator: James Free", "founding_year": "1958", "launchers": "Space Shuttle | SLS", "spacecraft": "Orion", "launch_library_url": null, "total_launch_count": 141, "consecutive_successful_launches": 11, "successful_launches": 121, "failed_launches": 20, "pending_launches": 6, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.nasa.gov", "wiki_url": "http://en.wikipedia.org/wiki/National_Aeronautics_and_Space_Administration", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_logo_20190207032448.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_image_20190207032448.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_nation_20230803040809.jpg" }, "program": [ { "id": 15, "url": "https://ll.thespacedevs.com/2.2.0/program/15/?format=api", "name": "Artemis", "description": "The Artemis program is a US government-funded crewed spaceflight program that has the goal of landing \"the first woman and the next man\" on the Moon, specifically at the lunar south pole region by 2024.", "agencies": [ { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/artemis_program_20220827100930.png", "start_date": "2017-12-11T00:00:00Z", "end_date": null, "info_url": "https://www.nasa.gov/specials/artemis/", "wiki_url": "https://en.wikipedia.org/wiki/Artemis_program", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "variant": "", "alias": "", "min_stage": 1, "max_stage": 1, "length": null, "diameter": 5.5, "maiden_flight": "2019-07-02", "launch_cost": null, "launch_mass": null, "leo_capacity": null, "gto_capacity": null, "to_thrust": 2200, "apogee": 9, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/orion2520abort2520test2520booster_image_20190701191116.jpeg", "info_url": "https://www.nasa.gov/sites/default/files/atoms/files/aa2_fact_sheet.pdf", "wiki_url": "https://en.wikipedia.org/wiki/Orion_Abort_Test_Booster", "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "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": 1006, "name": "Ascent Abort-2", "description": "Ascent Abort-2 (AA-2) is a scheduled test of the Launch Abort System (LAS) of NASA's Orion spacecraft.", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 15, "name": "Suborbital", "abbrev": "Sub" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 27, "url": "https://ll.thespacedevs.com/2.2.0/pad/27/?format=api", "agency_id": null, "name": "Space Launch Complex 46", "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Spaceport_Florida_Launch_Complex_46", "map_url": "https://www.google.com/maps?q=28.4584,-80.5284", "latitude": "28.4584", "longitude": "-80.5284", "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": 1021, "total_landing_count": 64 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_27_20200803143319.jpg", "total_launch_count": 6, "orbital_launch_attempt_count": 5 }, "infoURLs": [ { "priority": 0, "source": null, "title": "", "description": "", "feature_image": null, "url": "https://www.nasa.gov/sites/default/files/atoms/files/aa2_fact_sheet.pdf", "type": null, "language": null } ], "vidURLs": [ { "priority": 10, "source": "youtube.com", "publisher": "NASA", "title": "Launch of Orion Spacecraft Ascent Abort-2 Test", "description": "Watch a fully functional launch abort system (LAS) and test Orion spacecraft launch to an altitude of 31,000 feet at Mach 1.15 (more than 1,000 mph)! On July...", "feature_image": "https://i.ytimg.com/vi/rJgqhznBntE/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=rJgqhznBntE", "type": { "id": 6, "name": "Recap" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2019-07-02T18:35:09Z", "end_time": "2019-07-02T18:37:15Z" } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/orion2520abort2520test2520booster_image_20190701191116.jpeg", "infographic": null, "program": [ { "id": 15, "url": "https://ll.thespacedevs.com/2.2.0/program/15/?format=api", "name": "Artemis", "description": "The Artemis program is a US government-funded crewed spaceflight program that has the goal of landing \"the first woman and the next man\" on the Moon, specifically at the lunar south pole region by 2024.", "agencies": [ { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/artemis_program_20220827100930.png", "start_date": "2017-12-11T00:00:00Z", "end_date": null, "info_url": "https://www.nasa.gov/specials/artemis/", "wiki_url": "https://en.wikipedia.org/wiki/Artemis_program", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": null, "location_launch_attempt_count": 783, "pad_launch_attempt_count": 4, "agency_launch_attempt_count": 140, "orbital_launch_attempt_count_year": 0, "location_launch_attempt_count_year": 5, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P675DT4H56M", "mission_patches": [ { "id": 80, "name": "Orion Ascent Abort 2", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/orion2520ascen_mission_patch_20210903113251.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" }
