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/0640dd85-11c7-4a10-9947-9467f33cbaf2/?format=api
{ "id": "0640dd85-11c7-4a10-9947-9467f33cbaf2", "url": "https://ll.thespacedevs.com/2.2.0/launch/0640dd85-11c7-4a10-9947-9467f33cbaf2/?format=api", "slug": "atlas-lv-3b-big-joe-1", "flightclub_url": null, "r_spacex_api_id": null, "name": "Atlas LV-3B | Big Joe 1", "status": { "id": 7, "name": "Launch was a Partial Failure", "abbrev": "Partial Failure", "description": "Either the launch vehicle reached orbit but did not deliver its payload in the targeted orbit, or an exceptional event made it impossible to consider the mission a success." }, "last_updated": "2023-06-14T17:42:43Z", "updates": [], "net": "1959-09-09T08:19:00Z", "net_precision": null, "window_end": "1959-09-09T08:19:00Z", "window_start": "1959-09-09T08:19: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": 7429, "configuration": { "id": 162, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/162/?format=api", "name": "Atlas LV-3B", "active": false, "reusable": false, "description": "The Atlas LV-3B, Atlas D Mercury Launch Vehicle or Mercury-Atlas Launch Vehicle, was a human-rated expendable launch system used as part of the United States Project Mercury to send astronauts into low Earth orbit. Manufactured by American aircraft manufacturing company Convair, it was derived from the SM-65D Atlas missile, and was a member of the Atlas family of rockets.", "family": "Atlas", "full_name": "Atlas LV-3B", "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": 2, "url": "https://ll.thespacedevs.com/2.2.0/program/2/?format=api", "name": "Mercury", "description": "Project Mercury was the first human spaceflight program of the United States, running from 1958 through 1963.", "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/project2520mer_program_20200820194755.png", "start_date": "1958-10-07T00:00:00Z", "end_date": "1963-05-16T23:24:02Z", "info_url": "https://www.nasa.gov/mission_pages/mercury/missions/program-toc.html", "wiki_url": "https://en.wikipedia.org/wiki/Project_Mercury", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "variant": "LV-3B", "alias": "", "min_stage": 1, "max_stage": 1, "length": 28.7, "diameter": 3.0, "maiden_flight": "1960-07-29", "launch_cost": null, "launch_mass": 120, "leo_capacity": 1360, "gto_capacity": null, "to_thrust": 1300, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/atlas_image_20190222030015.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Atlas_LV-3B", "total_launch_count": 10, "consecutive_successful_launches": 6, "successful_launches": 7, "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": 5818, "name": "Big Joe 1", "description": "Suborbital flight with the objective of testing the Mercury spacecraft ablative heat shield. The Atlas booster section failed to jettison, leading to a lower apogee. It was nonetheless sufficient to satisfy the Mercury spacecraft team.", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 15, "name": "Suborbital", "abbrev": "Sub" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 17, "url": "https://ll.thespacedevs.com/2.2.0/pad/17/?format=api", "agency_id": 1048, "name": "Space Launch Complex 14", "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Air_Force_Station_Launch_Complex_14", "map_url": "https://www.google.com/maps?q=28.49103,-80.54687", "latitude": "28.49103", "longitude": "-80.54687", "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_17_20200803143405.jpg", "total_launch_count": 20, "orbital_launch_attempt_count": 16 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/atlas_image_20190222030015.jpeg", "infographic": null, "program": [ { "id": 2, "url": "https://ll.thespacedevs.com/2.2.0/program/2/?format=api", "name": "Mercury", "description": "Project Mercury was the first human spaceflight program of the United States, running from 1958 through 1963.", "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/project2520mer_program_20200820194755.png", "start_date": "1958-10-07T00:00:00Z", "end_date": "1963-05-16T23:24:02Z", "info_url": "https://www.nasa.gov/mission_pages/mercury/missions/program-toc.html", "wiki_url": "https://en.wikipedia.org/wiki/Project_Mercury", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": null, "location_launch_attempt_count": 26, "pad_launch_attempt_count": 1, "agency_launch_attempt_count": 6, "orbital_launch_attempt_count_year": 0, "location_launch_attempt_count_year": 8, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 5, "pad_turnaround": "P0D", "mission_patches": [], "type": "detailed" }
