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/8d2a11e2-51e3-4841-a616-d41589373025/?format=api
{ "id": "8d2a11e2-51e3-4841-a616-d41589373025", "url": "https://lldev.thespacedevs.com/2.2.0/launch/8d2a11e2-51e3-4841-a616-d41589373025/?format=api", "slug": "long-march-10a-demo-flight", "flightclub_url": null, "r_spacex_api_id": null, "name": "Long March 10A | Demo Flight", "status": { "id": 2, "name": "To Be Determined", "abbrev": "TBD", "description": "Current date is a placeholder or rough estimation based on unreliable or interpreted sources." }, "last_updated": "2025-12-01T16:44:21Z", "updates": [ { "id": 13088, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch.", "info_url": "https://x.com/raz_liu/status/1984449693146103940", "created_by": "Cosmic_Penguin", "created_on": "2025-12-01T16:44:00Z" } ], "net": "2026-12-31T00:00:00Z", "net_precision": { "id": 14, "name": "Year", "abbrev": "Y", "description": "The T-0 is expected in the given year." }, "window_end": "2026-12-31T00:00:00Z", "window_start": "2026-12-31T00:00:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 88, "url": "https://lldev.thespacedevs.com/2.2.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": 582, "consecutive_successful_launches": 8, "successful_launches": 567, "failed_launches": 15, "pending_launches": 12, "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, "url": "https://lldev.thespacedevs.com/2.2.0/config/launcher/537/?format=api", "name": "Long March 10A", "active": true, "reusable": true, "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.2.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": 582, "consecutive_successful_launches": 8, "successful_launches": 567, "failed_launches": 15, "pending_launches": 12, "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_cost": 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, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 7410, "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" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 241, "url": "https://lldev.thespacedevs.com/2.2.0/pad/241/?format=api", "agency_id": null, "name": "301", "description": "Launch pad for the Long March 10 and 10A rockets for future Chinese crew missions to the lunar surface and Low Earth Orbit space station.", "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.2.0/location/8/?format=api", "name": "Wenchang Space Launch Site, People's Republic of China", "country_code": "CHN", "description": "The Wenchang Space Launch Site is a rocket launch site located in Wenchang on the island of Hainan, in China.\r\n\r\nFormally a suborbital test center, it currently serves as China's southernmost spaceport. The site was selected for its low latitude, 19° north of the equator, allowing for larger payloads to be launched. It is capable of launching the Long March 5, the heaviest Chinese rocket. Unlike launch facilities on the mainland, Wenchang uses its seaport for deliveries.", "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_8_20200803142445.jpg", "timezone_name": "Asia/Shanghai", "total_launch_count": 58, "total_landing_count": 0 }, "country_code": "CHN", "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_301_20251128182017.jpg", "total_launch_count": 0, "orbital_launch_attempt_count": 0 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": null, "infographic": null, "program": [], "orbital_launch_attempt_count": 7441, "location_launch_attempt_count": 64, "pad_launch_attempt_count": 1, "agency_launch_attempt_count": 591, "orbital_launch_attempt_count_year": 268, "location_launch_attempt_count_year": 9, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 21, "pad_turnaround": "P0D", "mission_patches": [], "type": "detailed" }