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/6abb4584-1ae8-4280-ab94-eec203164091/?format=api
{ "id": "6abb4584-1ae8-4280-ab94-eec203164091", "url": "https://ll.thespacedevs.com/2.2.0/launch/6abb4584-1ae8-4280-ab94-eec203164091/?format=api", "slug": "vostok-k-vostok-1", "flightclub_url": null, "r_spacex_api_id": null, "name": "Vostok-K | Vostok 1", "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-14T08:38:41Z", "updates": [], "net": "1961-04-12T06:07:00Z", "net_precision": null, "window_end": "1961-04-12T06:07:00Z", "window_start": "1961-04-12T06:07:00Z", "probability": -1, "weather_concerns": null, "holdreason": "", "failreason": null, "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": 189, "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": 362, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/362/?format=api", "mission_end": "1961-04-12T07:55:00Z", "destination": "Low Earth Orbit", "launch_crew": [ { "id": 2997, "role": { "id": 2, "role": "Pilot", "priority": 2 }, "astronaut": { "id": 111, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/111/?format=api", "name": "Yuri Gagarin", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "PT1H48M", "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": "1934-03-09", "date_of_death": "1968-03-27", "nationality": "Russian", "twitter": null, "instagram": null, "bio": "Yuri Alekseyevich Gagarin (Russian: Ю́рий Алексе́евич Гага́рин, IPA: [ˈjʉrʲɪj ɐlʲɪˈksʲejɪvʲɪtɕ ɡɐˈɡarʲɪn]; 9 March 1934 – 27 March 1968) was a Soviet pilot and cosmonaut. He became the first human to journey into outer space when his Vostok spacecraft completed one orbit of the Earth on 12 April 1961.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/yuri2520gagarin_image_20200211151614.jpg", "wiki": "https://en.wikipedia.org/wiki/Yuri_Gagarin", "last_flight": "1961-04-12T06:07:00Z", "first_flight": "1961-04-12T06:07:00Z" } } ], "onboard_crew": [], "landing_crew": [ { "id": 783, "role": { "id": 2, "role": "Pilot", "priority": 2 }, "astronaut": { "id": 111, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/111/?format=api", "name": "Yuri Gagarin", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "PT1H48M", "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": "1934-03-09", "date_of_death": "1968-03-27", "nationality": "Russian", "twitter": null, "instagram": null, "bio": "Yuri Alekseyevich Gagarin (Russian: Ю́рий Алексе́евич Гага́рин, IPA: [ˈjʉrʲɪj ɐlʲɪˈksʲejɪvʲɪtɕ ɡɐˈɡarʲɪn]; 9 March 1934 – 27 March 1968) was a Soviet pilot and cosmonaut. He became the first human to journey into outer space when his Vostok spacecraft completed one orbit of the Earth on 12 April 1961.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/yuri2520gagarin_image_20200211151614.jpg", "wiki": "https://en.wikipedia.org/wiki/Yuri_Gagarin", "last_flight": "1961-04-12T06:07:00Z", "first_flight": "1961-04-12T06:07:00Z" } } ], "spacecraft": { "id": 227, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/227/?format=api", "name": "Vostok-3KA No.3", "serial_number": "Vostok-3KA No.3", "is_placeholder": false, "in_space": false, "time_in_space": "PT1H48M", "time_docked": "P0D", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "Vostok 1 was a Vostok spacecraft which launched on 12 April 1961 06:07 UTC. It transported one cosmonaut to Low Earth Orbit. The crew was Yuri Gagarin.", "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": 1068, "attempt": true, "success": true, "description": "The first manned Vostok spacecraft successfully touched down after a 1 hour, 46 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": 774, "name": "Vostok 1", "description": "The first crewed space launch & the first orbital launch. It carried the Soviet cosmonaut Yuri Gagarin who completed 1 orbit before safely re-entering the atmosphere, he ejected from his capsule at an altitude of 7 km in order to parachute safely to the ground. The mission lasted 108 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": 107, "location_launch_attempt_count": 25, "pad_launch_attempt_count": 25, "agency_launch_attempt_count": 25, "orbital_launch_attempt_count_year": 14, "location_launch_attempt_count_year": 5, "pad_launch_attempt_count_year": 5, "agency_launch_attempt_count_year": 5, "pad_turnaround": "P18DT13M", "mission_patches": [], "type": "detailed" }
