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/1901ff20-e1d1-45bd-bfc2-8e6cbf46bed9/?format=api
{ "id": "1901ff20-e1d1-45bd-bfc2-8e6cbf46bed9", "url": "https://ll.thespacedevs.com/2.2.0/launch/1901ff20-e1d1-45bd-bfc2-8e6cbf46bed9/?format=api", "slug": "vostok-k-vostok-3", "flightclub_url": null, "r_spacex_api_id": null, "name": "Vostok-K | Vostok 3", "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-06-16T09:54:52Z", "updates": [], "net": "1962-08-11T08:30:00Z", "net_precision": { "id": 1, "name": "Minute", "abbrev": "MIN", "description": "The T-0 is accurate to the minute." }, "window_end": "1962-08-11T08:30:00Z", "window_start": "1962-08-11T08:30:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 66, "url": "https://ll.thespacedevs.com/2.2.0/agencies/66/?format=api", "name": "Soviet Space Program", "featured": false, "type": "Government", "country_code": "RUS", "abbrev": "CCCP", "description": "The Soviet space program, was the national space program of the Union of Soviet Socialist Republics (USSR) actived from 1930s until disintegration of the Soviet Union in 1991.\r\n\r\nThe Soviet Union's space program was mainly based on the cosmonautic exploration of space and the development of the expandable launch vehicles, which had been split between many design bureaus competing against each other. Over its 60-years of history, the Russian program was responsible for a number of pioneering feats and accomplishments in the human space flight, including the first intercontinental ballistic missile (R-7), first satellite (Sputnik 1), first animal in Earth orbit (the dog Laika on Sputnik 2), first human in space and Earth orbit (cosmonaut Yuri Gagarin on Vostok 1), first woman in space and Earth orbit (cosmonaut Valentina Tereshkova on Vostok 6), first spacewalk (cosmonaut Alexei Leonov on Voskhod 2), first Moon impact (Luna 2), first image of the far side of the Moon (Luna 3) and unmanned lunar soft landing (Luna 9), first space rover (Lunokhod 1), first sample of lunar soil automatically extracted and brought to Earth (Luna 16), and first space station (Salyut 1). Further notable records included the first interplanetary probes: Venera 1 and Mars 1 to fly by Venus and Mars, respectively, Venera 3 and Mars 2 to impact the respective planet surface, and Venera 7 and Mars 3 to make soft landings on these planets.", "administrator": null, "founding_year": "1931", "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 2456, "consecutive_successful_launches": 17, "successful_launches": 2288, "failed_launches": 168, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "", "wiki_url": "http://en.wikipedia.org/wiki/Soviet_space_program", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soviet2520space2520program_logo_20191229081307.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soviet2520space2520program_image_20191229081306.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soviet2520space2520program_nation_20191229081307.png" }, "rocket": { "id": 193, "configuration": { "id": 103, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/103/?format=api", "name": "Vostok", "active": false, "reusable": false, "description": "The Vostok-K was an expendable carrier rocket used by the Soviet Union for thirteen launches between 1960 and 1964, six of which were manned.\r\n\r\nThe Vostok-K made its maiden flight on 22 December 1960, three weeks after the retirement of the Vostok-L. The third stage engine failed 425 seconds after launch, and the payload, a Korabl-Sputnik spacecraft, failed to reach orbit. The spacecraft was recovered after landing, and the two dogs aboard the spacecraft survived the flight.\r\n\r\nOn 12 April 1961, a Vostok-K rocket was used to launch Vostok 1, the first manned spaceflight, which made Yuri Gagarin the first human to fly in space.", "family": "R-7", "full_name": "Vostok-K", "manufacturer": { "id": 66, "url": "https://ll.thespacedevs.com/2.2.0/agencies/66/?format=api", "name": "Soviet Space Program", "featured": false, "type": "Government", "country_code": "RUS", "abbrev": "CCCP", "description": "The Soviet space program, was the national space program of the Union of Soviet Socialist Republics (USSR) actived from 1930s until disintegration of the Soviet Union in 1991.\r\n\r\nThe Soviet Union's space program was mainly based on the cosmonautic exploration of space and the development of the expandable launch vehicles, which had been split between many design bureaus competing against each other. Over its 60-years of history, the Russian program was responsible for a number of pioneering feats and accomplishments in the human space flight, including the first intercontinental ballistic missile (R-7), first satellite (Sputnik 1), first animal in Earth orbit (the dog Laika on Sputnik 2), first human in space and Earth orbit (cosmonaut Yuri Gagarin on Vostok 1), first woman in space and Earth orbit (cosmonaut Valentina Tereshkova on Vostok 6), first spacewalk (cosmonaut Alexei Leonov on Voskhod 2), first Moon impact (Luna 2), first image of the far side of the Moon (Luna 3) and unmanned lunar soft landing (Luna 9), first space rover (Lunokhod 1), first sample of lunar soil automatically extracted and brought to Earth (Luna 16), and first space station (Salyut 1). Further notable records included the first interplanetary probes: Venera 1 and Mars 1 to fly by Venus and Mars, respectively, Venera 3 and Mars 2 to impact the respective planet surface, and Venera 7 and Mars 3 to make soft landings on these planets.", "administrator": null, "founding_year": "1931", "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 2456, "consecutive_successful_launches": 17, "successful_launches": 2288, "failed_launches": 168, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "", "wiki_url": "http://en.wikipedia.org/wiki/Soviet_space_program", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soviet2520space2520program_logo_20191229081307.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soviet2520space2520program_image_20191229081306.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soviet2520space2520program_nation_20191229081307.png" }, "program": [ { "id": 9, "url": "https://ll.thespacedevs.com/2.2.0/program/9/?format=api", "name": "Vostok", "description": "The Vostok programme was a Soviet human spaceflight project to put the first Soviet citizens into low Earth orbit and return them safely. Competing with the United States Project Mercury, it succeeded in placing the first human into space, Yuri Gagarin, in a single orbit in Vostok 1 on April 12, 1961.", "agencies": [ { "id": 66, "url": "https://ll.thespacedevs.com/2.2.0/agencies/66/?format=api", "name": "Soviet Space Program", "type": "Government" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vostok_program_20210417063956.png", "start_date": "1961-04-12T06:07:00Z", "end_date": "1963-06-19T08:20:00Z", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Vostok_programme", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "variant": "K", "alias": "", "min_stage": 3, "max_stage": 3, "length": 30.84, "diameter": 2.99, "maiden_flight": "1960-05-15", "launch_cost": null, "launch_mass": 280, "leo_capacity": 4725, "gto_capacity": null, "to_thrust": 971, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vostok_image_20191104130128.jpg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Vostok-K", "total_launch_count": 13, "consecutive_successful_launches": 7, "successful_launches": 11, "failed_launches": 2, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": { "id": 360, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/360/?format=api", "mission_end": "1962-08-15T06:52:00Z", "destination": "Low Earth Orbit", "launch_crew": [ { "id": 2995, "role": { "id": 2, "role": "Pilot", "priority": 2 }, "astronaut": { "id": 210, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/210/?format=api", "name": "Andriyan Nikolayev", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "P21DT15H20M55S", "status": { "id": 11, "name": "Deceased" }, "agency": { "id": 63, "url": "https://ll.thespacedevs.com/2.2.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "type": "Government" }, "date_of_birth": "1929-09-05", "date_of_death": "2004-07-03", "nationality": "Russian", "twitter": null, "instagram": null, "bio": "Andriyan Grigoryevich Nikolayev was a Soviet cosmonaut. He was an ethnic Chuvash.\r\n\r\nNikolayev flew on two space flights: Vostok 3 (effectively becoming the third Soviet cosmonaut) and Soyuz 9. His call sign in these flights was Falcon (Russian: Со́кол). On both, he set new endurance records for the longest time a human being had remained in orbit. He also served as backup for the Vostok 2 and Soyuz 8 missions.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/andriyan2520nikolayev_image_20181201183434.jpg", "wiki": "https://en.wikipedia.org/wiki/Andriyan_Nikolayev", "last_flight": "1970-06-01T19:00:00Z", "first_flight": "1962-08-11T08:30:00Z" } } ], "onboard_crew": [], "landing_crew": [ { "id": 781, "role": { "id": 2, "role": "Pilot", "priority": 2 }, "astronaut": { "id": 210, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/210/?format=api", "name": "Andriyan Nikolayev", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "P21DT15H20M55S", "status": { "id": 11, "name": "Deceased" }, "agency": { "id": 63, "url": "https://ll.thespacedevs.com/2.2.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "type": "Government" }, "date_of_birth": "1929-09-05", "date_of_death": "2004-07-03", "nationality": "Russian", "twitter": null, "instagram": null, "bio": "Andriyan Grigoryevich Nikolayev was a Soviet cosmonaut. He was an ethnic Chuvash.\r\n\r\nNikolayev flew on two space flights: Vostok 3 (effectively becoming the third Soviet cosmonaut) and Soyuz 9. His call sign in these flights was Falcon (Russian: Со́кол). On both, he set new endurance records for the longest time a human being had remained in orbit. He also served as backup for the Vostok 2 and Soyuz 8 missions.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/andriyan2520nikolayev_image_20181201183434.jpg", "wiki": "https://en.wikipedia.org/wiki/Andriyan_Nikolayev", "last_flight": "1970-06-01T19:00:00Z", "first_flight": "1962-08-11T08:30:00Z" } } ], "spacecraft": { "id": 229, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/229/?format=api", "name": "Vostok-3KA No.5", "serial_number": "Vostok-3KA No.5", "is_placeholder": false, "in_space": false, "time_in_space": "P3DT22H22M", "time_docked": "P0D", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "Vostok 3 was a Vostok spacecraft which launched on 11 August 1962 08:24 UTC. It transported one cosmonaut to Low Earth Orbit. The crew was Andriyan Nikolayev.", "spacecraft_config": { "id": 15, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/15/?format=api", "name": "Vostok", "type": { "id": 2, "name": "Capsule" }, "agency": { "id": 63, "url": "https://ll.thespacedevs.com/2.2.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "featured": true, "type": "Government", "country_code": "RUS", "abbrev": "RFSA", "description": "The Roscosmos State Corporation for Space Activities, commonly known as Roscosmos, is the governmental body responsible for the space science program of the Russian Federation and general aerospace research. Soyuz has many launch locations the Russian sites are Baikonur, Plesetsk and Vostochny however Ariane also purchases the vehicle and launches it from French Guiana.", "administrator": "Administrator: Yuri Borisov", "founding_year": "1992", "launchers": "Soyuz", "spacecraft": "Soyuz", "parent": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_image_20190207032459.jpeg", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_logo_20190207032459.png" }, "in_use": false, "capability": "Human spaceflight in LEO.", "history": "The Vostok (Russian: Восток, translated as \"East\") was a type of spacecraft built by the Soviet Union. The spacecraft was part of the Vostok programme, in which six manned spaceflights were made, from 1961–63.", "details": "The Vostok-3KA consisted of a spherical descent module, which housed the cosmonaut, instruments and escape system, and a conical instrument module, which contained propellant and the engine system. \r\n\r\nOn reentry, the cosmonaut would eject from the craft at about 7,000 m (23,000 ft) and descend via parachute, while the capsule would land separately. The reason for this was that the Vostok descent module made an extremely rough landing that could have left a cosmonaut seriously injured.", "maiden_flight": "1960-05-15", "height": 4.55, "diameter": 2.43, "human_rated": true, "crew_capacity": 1, "payload_capacity": 4725, "payload_return_capacity": null, "flight_life": "Longest flight was 4 days.", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vostok-3ka_image_20190207032525.jpeg", "nation_url": null, "wiki_link": "https://en.wikipedia.org/wiki/Vostok_(spacecraft)", "info_link": "" } }, "landing": { "id": 1070, "attempt": true, "success": true, "description": "The Vostok spacecraft successfully touched down after a 3 days, 22 hours, 28 minutes flight. ", "downrange_distance": null, "location": { "id": 19, "name": "Kazakhstan", "abbrev": "KAZ", "description": "Deserts of Kazakhstan in Central Asia", "location": null, "successful_landings": 193 }, "type": { "id": 4, "name": "Parachute Landing", "abbrev": "PCL", "description": "Unpowered landing using parachute(s)." } }, "docking_events": [] } }, "mission": { "id": 850, "name": "Vostok 3", "description": "Vostok 3's mission goal was to test human body's ability to function in weightlessness and to test the Vostok 3KA spacecraft for longer flights. They also tested craft-to-craft communications by launching Vostok 4 a day after Vostok 3. Their trajectories brought them approximately 6.5 km from each other and cosmonauts were able to communicate via radio. This also marked the first time more than one crewed craft was orbiting earth at the same time. The spacecraft carried cosmonaut Andriyan Nikolayev to orbit where he orbited Earth 64 times before reentering. The mission lasted for 3 days 22 hours & 28 minutes.", "launch_designator": null, "type": "Human Exploration", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 32, "url": "https://ll.thespacedevs.com/2.2.0/pad/32/?format=api", "agency_id": null, "name": "1/5", "description": null, "info_url": null, "wiki_url": "", "map_url": "https://www.google.com/maps?q=45.92,63.342", "latitude": "45.92", "longitude": "63.342", "location": { "id": 15, "url": "https://ll.thespacedevs.com/2.2.0/location/15/?format=api", "name": "Baikonur Cosmodrome, Republic of Kazakhstan", "country_code": "KAZ", "description": "The Baikonur Cosmodrome is a spaceport operated by Russia within Kazakhstan. Located in the Kazakh city of Baikonur, it is the largest operational space launch facility in terms of area. All Russian crewed spaceflights are launched from Baikonur.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_15_20200803142517.jpg", "timezone_name": "Asia/Qyzylorda", "total_launch_count": 1554, "total_landing_count": 0 }, "country_code": "KAZ", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_32_20200803143513.jpg", "total_launch_count": 487, "orbital_launch_attempt_count": 487 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vostok_image_20191104130128.jpg", "infographic": null, "program": [ { "id": 9, "url": "https://ll.thespacedevs.com/2.2.0/program/9/?format=api", "name": "Vostok", "description": "The Vostok programme was a Soviet human spaceflight project to put the first Soviet citizens into low Earth orbit and return them safely. Competing with the United States Project Mercury, it succeeded in placing the first human into space, Yuri Gagarin, in a single orbit in Vostok 1 on April 12, 1961.", "agencies": [ { "id": 66, "url": "https://ll.thespacedevs.com/2.2.0/agencies/66/?format=api", "name": "Soviet Space Program", "type": "Government" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vostok_program_20210417063956.png", "start_date": "1961-04-12T06:07:00Z", "end_date": "1963-06-19T08:20:00Z", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Vostok_programme", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": 186, "location_launch_attempt_count": 31, "pad_launch_attempt_count": 31, "agency_launch_attempt_count": 36, "orbital_launch_attempt_count_year": 44, "location_launch_attempt_count_year": 4, "pad_launch_attempt_count_year": 4, "agency_launch_attempt_count_year": 9, "pad_turnaround": "P13DT23H11M29S", "mission_patches": [], "type": "detailed" }
