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/1e79a5e9-c02c-470f-882f-884120100fef/?format=api
{ "id": "1e79a5e9-c02c-470f-882f-884120100fef", "url": "https://lldev.thespacedevs.com/2.0.0/launch/1e79a5e9-c02c-470f-882f-884120100fef/?format=api", "launch_library_id": null, "slug": "long-march-10b-demo-flight", "name": "Long March 10B | Demo Flight", "status": { "id": 3, "name": "Success" }, "net": "2026-07-10T04:15:00Z", "window_end": "2026-07-10T04:49:00Z", "window_start": "2026-07-10T04:02:00Z", "inhold": false, "tbdtime": false, "tbddate": false, "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": 608, "consecutive_successful_launches": 34, "successful_launches": 593, "failed_launches": 15, "pending_launches": 7, "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": 8938, "configuration": { "id": 554, "launch_library_id": null, "url": "https://lldev.thespacedevs.com/2.0.0/config/launcher/554/?format=api", "name": "Long March 10B", "description": "The Long March 10B is a reusable launch vehicle based on the 1st stage of the Long March 10A, in turn derived from 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. Like the Long March 10A, the 10B’s 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.\r\n\r\nThe 2nd stage, however, uses a single YF-219 gas generator cycle methane/liquid oxygen engine with 140 tonnes of thrust.\r\n\r\nThe Long March 10B became China's first orbital launch vehicle with its first stage booster being recovered, during its first launch on 10 July 2026.", "family": "Long March", "full_name": "Long March 10B", "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": 608, "consecutive_successful_launches": 34, "successful_launches": 593, "failed_launches": 15, "pending_launches": 7, "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": "", "alias": "CZ-10B", "min_stage": 2, "max_stage": 2, "length": 63.0, "diameter": 5.0, "maiden_flight": "2026-07-10", "launch_mass": 760, "leo_capacity": 16000, "gto_capacity": null, "to_thrust": 8728, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/long_march_10b__image_20260710054044.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Long_March_10B", "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "pending_launches": 0 }, "launcher_stage": [ { "id": 958, "type": "Core", "reused": false, "launcher_flight_number": 1, "launcher": { "id": 254, "url": "https://lldev.thespacedevs.com/2.0.0/launcher/254/?format=api", "details": "First stage booster used on the 1st flight of CASC/CALT's Long March 10B rocket. Grid fins and hooks are installed for an attempted recovery on the LHZ landing ship's arresting net.\r\n\r\nIt became the first Chinese orbital launch vehicle booster to be recovered on 10 July 2026.", "flight_proven": true, "serial_number": "LM-10B F1", "status": "active", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/long_march_10b__image_20260710054044.jpeg", "successful_landings": 1, "attempted_landings": 1, "flights": 1, "last_launch_date": "2026-07-10T04:15:00Z", "first_launch_date": "2026-07-10T04:15:00Z" }, "landing": { "id": 1890, "attempt": true, "success": true, "description": "The Long March 10B first stage booster has landed on Ling Hang Zhe after its 1st flight.", "location": { "id": 63, "name": "Ling Hang Zhe", "abbrev": "LHZ", "description": "Chinese rocket recovery ship operated by the China Aerospace Science and Technology Corporation for catching of first stage boosters of the Long March 10 series of rockets. It uses an \"arresting net\" installed on a high frame that catches hooks installed on the 1st stage boosters with cables.", "location": null, "successful_landings": 1 }, "type": { "id": 1, "name": "Autonomous Spaceport Drone Ship", "abbrev": "ASDS", "description": "An autonomous spaceport drone ship (ASDS) is an ocean-going vessel derived from a deck barge, outfitted with station-keeping engines and a large landing platform. Construction of such ships was commissioned by aerospace company SpaceX to allow for recovery of rocket first-stages at sea for high-velocity missions which do not carry enough fuel to return to the launch site after lofting spacecraft onto an orbital trajectory." } }, "previous_flight_date": null, "turn_around_time_days": null, "previous_flight": null } ], "spacecraft_stage": null }, "mission": { "id": 7533, "launch_library_id": null, "name": "Demo Flight", "description": "First launch of the Long March 10B rocket and first ever successful rocket booster recovery of a Chinese launch vehicle.\r\n\r\nPayloads on board is TBD.", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" } }, "pad": { "id": 219, "url": "https://lldev.thespacedevs.com/2.0.0/pad/219/?format=api", "agency_id": null, "name": "Commercial LC-2", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Wenchang_Commercial_Space_Launch_Site", "map_url": "https://www.google.com/maps?q=19.59755,110.936481", "latitude": "19.59755", "longitude": "110.936481", "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": 70, "total_landing_count": 0 }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_commercial_lc-2_20231225074048.jpg", "total_launch_count": 7 }, "infoURLs": [], "vidURLs": [ { "priority": 10, "title": "Live: Long March 10B Demo Flight Launch (No Commentary)", "description": "Footage courtesy of 追箭部落/读屏标签已关闭/文昌绿发希尔顿酒店/Tony哥游天下/文昌海石滩民宿官方号/文昌极星陨石博物馆\nThumbnail shot by 翼下地球-chenxiao\n\nInternational Rocket Launches provides commentary-free coverage of select global rocket launches.\n\nFollow @IntRocketLaunch on Twitter: https://twitter.com/IntRocketLaunch \n\nRestreaming and reuse are permitted with credit to both the original source and @IntRocketLaunch.", "feature_image": "https://i.ytimg.com/vi/QOT4CBR6ryg/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=QOT4CBR6ryg" } ], "webcast_live": false, "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/long_march_10b__image_20260710054044.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7337, "location_launch_attempt_count": 68, "pad_launch_attempt_count": 7, "agency_launch_attempt_count": 604, "orbital_launch_attempt_count_year": 164, "location_launch_attempt_count_year": 13, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 34 }
