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/02b8bb48-37a1-4f43-9112-33d8e8589a75/?format=api
{ "id": "02b8bb48-37a1-4f43-9112-33d8e8589a75", "url": "https://ll.thespacedevs.com/2.2.0/launch/02b8bb48-37a1-4f43-9112-33d8e8589a75/?format=api", "slug": "vostok-8k72-korabl-sputnik-1", "flightclub_url": null, "r_spacex_api_id": null, "name": "Vostok 8K72 | Korabl'-Sputnik-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-14T03:48:47Z", "updates": [], "net": "1960-05-15T00:00:05Z", "net_precision": null, "window_end": "1960-05-15T00:00:05Z", "window_start": "1960-05-15T00:00:05Z", "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": 3068, "configuration": { "id": 453, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/453/?format=api", "name": "Vostok 8K72", "active": false, "reusable": false, "description": "Vostok was a family of rockets derived from the Soviet R-7 Semyorka ICBM and was designed for the human spaceflight programme.", "family": "Vostok", "full_name": "Vostok 8K72", "manufacturer": { "id": 103, "url": "https://ll.thespacedevs.com/2.2.0/agencies/103/?format=api", "name": "RKK Energiya", "featured": false, "type": "Commercial", "country_code": "RUS", "abbrev": "RSC", "description": null, "administrator": null, "founding_year": null, "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.energia.ru/english/", "wiki_url": "http://en.wikipedia.org/wiki/S.P._Korolev_Rocket_and_Space_Corporation_Energia", "logo_url": null, "image_url": null, "nation_url": null }, "program": [], "variant": "8K72", "alias": "", "min_stage": 2, "max_stage": 2, "length": 30.84, "diameter": 2.99, "maiden_flight": "1960-05-15", "launch_cost": null, "launch_mass": 281, "leo_capacity": 4550, "gto_capacity": null, "to_thrust": 3873, "apogee": null, "vehicle_range": null, "image_url": null, "info_url": "", "wiki_url": "https://en.wikipedia.org/wiki/Vostok_(rocket_family)", "total_launch_count": 4, "consecutive_successful_launches": 2, "successful_launches": 3, "failed_launches": 1, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": { "id": 746, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/746/?format=api", "mission_end": "1962-09-05T00:00:00Z", "destination": "Low Earth Orbit", "launch_crew": [], "onboard_crew": [], "landing_crew": [], "spacecraft": { "id": 529, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/529/?format=api", "name": "Vostok-1P", "serial_number": "Vostok-1P", "is_placeholder": false, "in_space": false, "time_in_space": "P842DT23H59M55S", "time_docked": "P0D", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "First Vostok spacecraft. The 1P variant was not designed to be recovered from orbit.", "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": 1065, "attempt": false, "success": null, "description": "The first ever Vostok spacecraft was lost in orbit.", "downrange_distance": null, "location": null, "type": null }, "docking_events": [] } }, "mission": { "id": 1490, "name": "Korabl'-Sputnik-1", "description": "Korabl-Sputnik was the first test flight of the Vostok programme and the first Vostok spacecraft.", "launch_designator": null, "type": "Test Flight", "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": 1555, "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": null, "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": 66, "location_launch_attempt_count": 14, "pad_launch_attempt_count": 14, "agency_launch_attempt_count": 14, "orbital_launch_attempt_count_year": 12, "location_launch_attempt_count_year": 3, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 3, "pad_turnaround": "P28DT7H52M24S", "mission_patches": [], "type": "detailed" }
