Launch Instance
API endpoint that returns all Launch objects or a single launch.
EXAMPLE - /launch/
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'
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.0.0/launch/928dbe8e-410c-44b2-aba0-fe4ca9b89200/?format=api
{ "id": "928dbe8e-410c-44b2-aba0-fe4ca9b89200", "url": "https://lldev.thespacedevs.com/2.0.0/launch/928dbe8e-410c-44b2-aba0-fe4ca9b89200/?format=api", "launch_library_id": null, "slug": "long-march-5b-xuntian-telescope", "name": "Long March 5B | Xuntian Telescope", "status": { "id": 2, "name": "TBD" }, "net": "2027-12-31T00:00:00Z", "window_end": "2027-12-31T00:00:00Z", "window_start": "2027-12-31T00:00:00Z", "inhold": false, "tbdtime": true, "tbddate": true, "probability": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 88, "url": "https://lldev.thespacedevs.com/2.0.0/agencies/88/?format=api", "name": "China Aerospace Science and Technology Corporation", "featured": true, "type": "Government", "country_code": "CHN", "abbrev": "CASC", "description": "The China Aerospace Science and Technology Corporation (CASC) is the main contractor for the Chinese space program. It is state-owned and has a number of subordinate entities which design, develop and manufacture a range of spacecraft, launch vehicles, strategic and tactical missile systems, and ground equipment. It was officially established in July 1999 as part of a Chinese government reform drive, having previously been one part of the former China Aerospace Corporation. Various incarnations of the program date back to 1956.", "administrator": "Chairman & President: Lei Fanpei", "founding_year": "1999", "launchers": "Long March", "spacecraft": "", "launch_library_url": null, "total_launch_count": 624, "consecutive_successful_launches": 15, "successful_launches": 608, "failed_launches": 16, "pending_launches": 8, "consecutive_successful_landings": 1, "successful_landings": 1, "failed_landings": 1, "attempted_landings": 2, "info_url": "https://english.spacechina.com/", "wiki_url": "https://en.wikipedia.org/wiki/China_Aerospace_Science_and_Technology_Corporation", "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_logo_20220826093937.png", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_image_20191228094408.jpeg", "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_nation_20230604193716.png" }, "rocket": { "id": 8857, "configuration": { "id": 208, "launch_library_id": 240, "url": "https://lldev.thespacedevs.com/2.0.0/config/launcher/208/?format=api", "name": "Long March 5B", "description": "The configuration of the CZ-5B variant consists of the Long March 5 core stage with its four strapped-on liquid-fueled boosters, but the usual second stage will be absent; in place of the second stage would be heavier low earth orbit payloads.", "family": "Long March", "full_name": "Long March 5B", "manufacturer": { "id": 88, "url": "https://lldev.thespacedevs.com/2.0.0/agencies/88/?format=api", "name": "China Aerospace Science and Technology Corporation", "featured": true, "type": "Government", "country_code": "CHN", "abbrev": "CASC", "description": "The China Aerospace Science and Technology Corporation (CASC) is the main contractor for the Chinese space program. It is state-owned and has a number of subordinate entities which design, develop and manufacture a range of spacecraft, launch vehicles, strategic and tactical missile systems, and ground equipment. It was officially established in July 1999 as part of a Chinese government reform drive, having previously been one part of the former China Aerospace Corporation. Various incarnations of the program date back to 1956.", "administrator": "Chairman & President: Lei Fanpei", "founding_year": "1999", "launchers": "Long March", "spacecraft": "", "launch_library_url": null, "total_launch_count": 624, "consecutive_successful_launches": 15, "successful_launches": 608, "failed_launches": 16, "pending_launches": 8, "consecutive_successful_landings": 1, "successful_landings": 1, "failed_landings": 1, "attempted_landings": 2, "info_url": "https://english.spacechina.com/", "wiki_url": "https://en.wikipedia.org/wiki/China_Aerospace_Science_and_Technology_Corporation", "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_logo_20220826093937.png", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_image_20191228094408.jpeg", "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_nation_20230604193716.png" }, "program": [], "variant": "B", "alias": "", "min_stage": 1, "max_stage": 1, "length": 53.66, "diameter": 5.0, "maiden_flight": "2020-05-05", "launch_mass": 837, "leo_capacity": 25000, "gto_capacity": null, "to_thrust": 10565, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/long_march_5b__image_20250906200134.jpg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Long_March_5", "total_launch_count": 4, "consecutive_successful_launches": 4, "successful_launches": 4, "failed_launches": 0, "pending_launches": 1 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 7448, "launch_library_id": null, "name": "Xuntian Telescope", "description": "Xuntian, formerly known as the Chinese Space Station Telescope (CSST), is a Chinese space telescope designed to perform high-resolution, large-area, multi-band imaging and slit-less spectroscopy surveys of the sky at ultraviolet to infrared wavelengths of 255 – 1000 nm. The survey camera is slated to cover approximately 17500 square degrees of the sky in various bands, reaching maximum magnitudes of about 26.\r\n\r\nXuntian will carry a survey camera, a tera-hertz receiver, a multi-channel imager, an integral field spectrograph, and a cool planet imaging coronagraph.\r\n\r\nXuntian will be launched to a Low Earth Orbit that will be co-orbiting with the Tiangong space station/Chinese Space Station, which will allow for periodic docking with the station for regular maintenance by astronauts.", "launch_designator": null, "type": "Astrophysics", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" } }, "pad": { "id": 175, "url": "https://lldev.thespacedevs.com/2.0.0/pad/175/?format=api", "agency_id": null, "name": "101", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Wenchang_Spacecraft_Launch_Site", "map_url": "https://www.google.com/maps?q=19.614334,110.951011", "latitude": "19.614334", "longitude": "110.951011", "location": { "id": 8, "url": "https://lldev.thespacedevs.com/2.0.0/location/8/?format=api", "name": "Wenchang Space Launch Site, People's Republic of China", "country_code": "CHN", "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_8_20200803142445.jpg", "total_launch_count": 77, "total_landing_count": 0 }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_175_20200803143424.jpg", "total_launch_count": 18 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/long_march_5b__image_20250906200134.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7685, "location_launch_attempt_count": 84, "pad_launch_attempt_count": 20, "agency_launch_attempt_count": 633, "orbital_launch_attempt_count_year": 156, "location_launch_attempt_count_year": 3, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 3 }
