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/373e4f88-3f51-415c-a9f3-3d926c983694/?format=api
{ "id": "373e4f88-3f51-415c-a9f3-3d926c983694", "url": "https://ll.thespacedevs.com/2.2.0/launch/373e4f88-3f51-415c-a9f3-3d926c983694/?format=api", "slug": "atlas-lv-3b-mercury-atlas-9", "flightclub_url": null, "r_spacex_api_id": null, "name": "Atlas LV-3B | Mercury-Atlas 9", "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-14T17:42:43Z", "updates": [], "net": "1963-05-15T13:04:13Z", "net_precision": null, "window_end": "1963-05-15T13:04:13Z", "window_start": "1963-05-15T13:04:13Z", "probability": -1, "weather_concerns": null, "holdreason": "", "failreason": null, "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": "Administrator: Bill Nelson", "founding_year": "1958", "launchers": "Space Shuttle | SLS", "spacecraft": "Orion", "launch_library_url": null, "total_launch_count": 135, "consecutive_successful_launches": 11, "successful_launches": 115, "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://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_logo_20190207032448.png", "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_image_20190207032448.jpeg", "nation_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_nation_20230803040809.jpg" }, "rocket": { "id": 196, "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": "Administrator: Bill Nelson", "founding_year": "1958", "launchers": "Space Shuttle | SLS", "spacecraft": "Orion", "launch_library_url": null, "total_launch_count": 135, "consecutive_successful_launches": 11, "successful_launches": 115, "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://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_logo_20190207032448.png", "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_image_20190207032448.jpeg", "nation_url": "https://spacelaunchnow-prod-east.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://spacelaunchnow-prod-east.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://spacelaunchnow-prod-east.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": { "id": 5, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/5/?format=api", "mission_end": "1963-05-16T23:24:00Z", "destination": "Low Earth Orbit", "launch_crew": [ { "id": 928, "role": { "id": 2, "role": "Pilot", "priority": 2 }, "astronaut": { "id": 24, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/24/?format=api", "name": "Gordon Cooper", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "P9DT9H15M1S", "status": { "id": 11, "name": "Deceased" }, "agency": { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, "date_of_birth": "1927-03-06", "date_of_death": "2004-10-04", "nationality": "American", "twitter": null, "instagram": null, "bio": "Leroy Gordon \"Gordo\" Cooper Jr. was an American aerospace engineer, test pilot, United States Air Force pilot, and the youngest of the seven original astronauts in Project Mercury, the first manned space program of the United States.\r\n\r\nCooper piloted the longest and final Mercury spaceflight in 1963. He was the first American to sleep in space during that 34-hour mission and was the last American to be launched alone to conduct an entirely solo orbital mission. In 1965, Cooper flew as Command Pilot of Gemini 5.", "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/gordon2520cooper_image_20190426143645.jpeg", "wiki": "https://en.wikipedia.org/wiki/Gordon_Cooper", "last_flight": "1965-08-21T13:59:59Z", "first_flight": "1963-05-15T13:04:13Z" } } ], "onboard_crew": [], "landing_crew": [ { "id": 8, "role": { "id": 2, "role": "Pilot", "priority": 2 }, "astronaut": { "id": 24, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/24/?format=api", "name": "Gordon Cooper", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "P9DT9H15M1S", "status": { "id": 11, "name": "Deceased" }, "agency": { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, "date_of_birth": "1927-03-06", "date_of_death": "2004-10-04", "nationality": "American", "twitter": null, "instagram": null, "bio": "Leroy Gordon \"Gordo\" Cooper Jr. was an American aerospace engineer, test pilot, United States Air Force pilot, and the youngest of the seven original astronauts in Project Mercury, the first manned space program of the United States.\r\n\r\nCooper piloted the longest and final Mercury spaceflight in 1963. He was the first American to sleep in space during that 34-hour mission and was the last American to be launched alone to conduct an entirely solo orbital mission. In 1965, Cooper flew as Command Pilot of Gemini 5.", "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/gordon2520cooper_image_20190426143645.jpeg", "wiki": "https://en.wikipedia.org/wiki/Gordon_Cooper", "last_flight": "1965-08-21T13:59:59Z", "first_flight": "1963-05-15T13:04:13Z" } } ], "spacecraft": { "id": 7, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/7/?format=api", "name": "Mercury No.20", "serial_number": "20", "is_placeholder": false, "in_space": false, "time_in_space": "P1DT10H19M47S", "time_docked": "P0D", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "Mercury No.20 is the Mercury capsule used for the Mercury-Atlas 9 - callsign \"Faith 7\" - mission launched on May 15, 1963 and piloted by astronaut Gordon Cooper.", "spacecraft_config": { "id": 11, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/11/?format=api", "name": "Mercury", "type": { "id": 2, "name": "Capsule" }, "agency": { "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": "Administrator: Bill Nelson", "founding_year": "1958", "launchers": "Space Shuttle | SLS", "spacecraft": "Orion", "parent": null, "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_image_20190207032448.jpeg", "logo_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_logo_20190207032448.png" }, "in_use": false, "capability": "Human transportation to upper Earth atmosphere and low Earth orbit.", "history": "The Mercury spacecraft was the manned capsule used for suborbital and orbital launches during the Project Mercury, the first human spaceflight program of the United States, from 1958 through 1963.", "details": "The Mercury spacecraft's principal designer was Maxime Faget, who started research for manned spaceflight during the time of the NACA. With 100 cubic feet (2.8 m3) of habitable volume, the capsule was just large enough for a single crew member. Inside were 120 controls: 55 electrical switches, 30 fuses and 35 mechanical levers. The heaviest spacecraft, Mercury-Atlas 9, weighed 3,000 pounds (1,400 kg) fully loaded. Its outer skin was made of René 41, a nickel alloy able to withstand high temperatures.", "maiden_flight": "1961-05-05", "height": 3.3, "diameter": 1.8, "human_rated": true, "crew_capacity": 1, "payload_capacity": null, "payload_return_capacity": null, "flight_life": "Between 15 minutes and 3 days.", "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/mercury_image_20190207032519.jpeg", "nation_url": null, "wiki_link": "https://en.wikipedia.org/wiki/Project_Mercury#Spacecraft", "info_link": "" } }, "landing": { "id": 488, "attempt": true, "success": true, "description": "The Mercury spacecraft safely splashed down in the Pacific Ocean.", "downrange_distance": null, "location": { "id": 18, "name": "Pacific Ocean", "abbrev": "PAC", "description": "Pacific Ocean", "location": null, "successful_landings": 3 }, "type": { "id": 4, "name": "Parachute Landing", "abbrev": "PL", "description": "Unpowered landing using parachute(s)." } }, "docking_events": [] } }, "mission": { "id": 158, "name": "Mercury-Atlas 9", "description": "Mercury-Atlas 9 was the final manned spaceflight of the United States' Mercury program. It carried the Faith 7 spacecraft with astronaut Gordon Cooper to orbit where it completed 22 orbits seconds before reentry. The mission lasted for, 34 hours, 19 minutes & 49 seconds. This was the last time an American was launched to space on a solo orbital mission. The mission had several technical problems, the biggest which was a short-circuit in the bus bar serving the 250 volt main inverter causing the automatic stabilization and control system to stop working during the 21st orbit. In the end Cooper had to use lines he had drawn on the window and his wristwatch to correctly execute burns to safely re-enter the atmosphere.", "launch_designator": null, "type": "Human Exploration", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "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, FL, USA", "country_code": "USA", "description": "", "map_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/launch_images/location_12_20200803142519.jpg", "timezone_name": "America/New_York", "total_launch_count": 951, "total_landing_count": 51 }, "country_code": "USA", "map_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/launch_images/pad_17_20200803143405.jpg", "total_launch_count": 20, "orbital_launch_attempt_count": 15 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://spacelaunchnow-prod-east.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://spacelaunchnow-prod-east.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": 245, "location_launch_attempt_count": 99, "pad_launch_attempt_count": 13, "agency_launch_attempt_count": 47, "orbital_launch_attempt_count_year": 22, "location_launch_attempt_count_year": 5, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 2, "pad_turnaround": "P224DT49M1S", "mission_patches": [ { "id": 141, "name": "Mercury-Atlas 9 Patch", "priority": 10, "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/mission_patch_images/mercury-atlas2_mission_patch_20211031042538.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" }
