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/8d2a11e2-51e3-4841-a616-d41589373025/?format=api
{ "id": "8d2a11e2-51e3-4841-a616-d41589373025", "url": "https://lldev.thespacedevs.com/2.0.0/launch/8d2a11e2-51e3-4841-a616-d41589373025/?format=api", "launch_library_id": null, "slug": "long-march-10a-demo-flight", "name": "Long March 10A | Demo Flight", "status": { "id": 2, "name": "TBD" }, "net": "2026-12-31T00:00:00Z", "window_end": "2026-12-31T00:00:00Z", "window_start": "2026-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": 587, "consecutive_successful_launches": 13, "successful_launches": 572, "failed_launches": 15, "pending_launches": 10, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 1, "attempted_landings": 1, "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": 8819, "configuration": { "id": 537, "launch_library_id": null, "url": "https://lldev.thespacedevs.com/2.0.0/config/launcher/537/?format=api", "name": "Long March 10A", "description": "The Long March 10A is a human-rated launch vehicle designed to replace the current Long March 2F, along with the Low Earth Orbit version of China's Mengzhou crewed spacecraft, as their new Low Earth Orbit crew missions launcher. \r\n\r\nIt is based on a single 1st stage core of the Long March 10, with 7 YF-100 series kerosene/liquid oxygen staged-combustion cycle engines on the 1st stage and 1 on the 2nd stage. The 1st stage is designed to be recovered downrange by a recovery barge equipped with an arrestor net and support frame, with the 1st stage landing on the net’s cables using its grid fins.", "family": "Long March", "full_name": "Long March 10A", "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": 587, "consecutive_successful_launches": 13, "successful_launches": 572, "failed_launches": 15, "pending_launches": 10, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 1, "attempted_landings": 1, "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": "", "alias": "CZ-10A", "min_stage": 2, "max_stage": 2, "length": 67.4, "diameter": 5.0, "maiden_flight": null, "launch_mass": 750, "leo_capacity": 18000, "gto_capacity": null, "to_thrust": 8750, "apogee": null, "vehicle_range": null, "image_url": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Long_March_10A", "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 1 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 7410, "launch_library_id": null, "name": "Demo Flight", "description": "First test launch of CASC/CALT’s Long March 10A rocket. Payload is expected to be a prototype of the Low Earth Orbit mission version of the Mengzhou crew spacecraft.", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 25, "name": "Unknown", "abbrev": "N/A" } }, "pad": { "id": 241, "url": "https://lldev.thespacedevs.com/2.0.0/pad/241/?format=api", "agency_id": null, "name": "301", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Wenchang_Space_Launch_Site", "map_url": "https://www.google.com/maps?q=19.610019,110.944443", "latitude": "19.610019", "longitude": "110.944443", "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": 59, "total_landing_count": 0 }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_301_20251128182017.jpg", "total_launch_count": 0 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "image": null, "infographic": null, "program": [], "orbital_launch_attempt_count": 7459, "location_launch_attempt_count": 65, "pad_launch_attempt_count": 1, "agency_launch_attempt_count": 595, "orbital_launch_attempt_count_year": 286, "location_launch_attempt_count_year": 10, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 25 }
