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/beac6ac1-97dd-4eb2-912c-8b4d4d15cd4e/?format=api
{ "id": "beac6ac1-97dd-4eb2-912c-8b4d4d15cd4e", "url": "https://lldev.thespacedevs.com/2.0.0/launch/beac6ac1-97dd-4eb2-912c-8b4d4d15cd4e/?format=api", "launch_library_id": null, "slug": "long-march-7a-tianlian-3-01", "name": "Long March 7A | Tianlian 3-01", "status": { "id": 3, "name": "Success" }, "net": "2026-07-29T11:50:00Z", "window_end": "2026-07-29T13:39:00Z", "window_start": "2026-07-29T11:42: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": 612, "consecutive_successful_launches": 3, "successful_launches": 596, "failed_launches": 16, "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": 9082, "configuration": { "id": 216, "launch_library_id": 247, "url": "https://lldev.thespacedevs.com/2.0.0/config/launcher/216/?format=api", "name": "Long March 7A", "description": "", "family": "Long March", "full_name": "Long March 7A", "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": 612, "consecutive_successful_launches": 3, "successful_launches": 596, "failed_launches": 16, "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": "A", "alias": "", "min_stage": null, "max_stage": null, "length": null, "diameter": null, "maiden_flight": "2020-03-16", "launch_mass": null, "leo_capacity": null, "gto_capacity": null, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/cz-7a_launch_2_image_20251206093324.jpeg", "info_url": null, "wiki_url": null, "total_launch_count": 18, "consecutive_successful_launches": 0, "successful_launches": 16, "failed_launches": 2, "pending_launches": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 7677, "launch_library_id": null, "name": "Tianlian 3-01", "description": "Tianlian is a Chinese data tracking and relay communications geostationary satellite series. The TL-3 (Tian Lian 3) satellites are the 3rd generation of China's geostationary orbit data relay satellites, based on the DFH-4E geostationary satellite bus. They will be used to support real-time communications between orbiting satellites/rockets in-flight and ground control stations. \r\n\r\nThis system replaces/supplements the current network of ground-based space tracking and telemetry stations and space tracking ships.", "launch_designator": null, "type": "Communications", "orbit": { "id": 2, "name": "Geostationary Transfer Orbit", "abbrev": "GTO" } }, "pad": { "id": 176, "url": "https://lldev.thespacedevs.com/2.0.0/pad/176/?format=api", "agency_id": null, "name": "201", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Wenchang_Spacecraft_Launch_Site", "map_url": "https://www.google.com/maps?q=19.618452,110.955356", "latitude": "19.618452", "longitude": "110.955356", "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": 72, "total_landing_count": 0 }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_176_20200803143412.jpg", "total_launch_count": 33 }, "infoURLs": [], "vidURLs": [ { "priority": 10, "title": "Live: Long March 7A Flight 17 Launch (No Commentary)", "description": "Wenchang launch coverage in partnership with 追箭部落\n\nAdditional footage courtesy of 山屿海民宿(淇水湾店)专用号/海南文昌华美胜地/文昌温德姆至尊豪廷大酒店康乐部/行走的Mr·Xiao/文昌瑶光火箭发射观礼平台/“胡”说海南\n\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/jTdmPsAGqb8/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=jTdmPsAGqb8" }, { "priority": 11, "title": "(ON LOCATION) Watch Long March 7A Launch Tianlian-3-01 from Wenchang, LIVE!!", "description": "Credits: TSDG Wenchang\n-------------------------------------------------------------\nSubscribe and follow my socials for more content!!!\n▶️ Twitter/X @TestAiden [ThatSpaceDogeGuy]\n▶️ Instagram | ThatSpaceDogeGuy\n▶️ Tiktok | ThatSpaceDogeGuy\n▶️ Twitch | ThatSpaceDogeGuy\n\nFootage from TSDG may be reused only with proper credit. Credit must be clearly visible in the video or included in the description. Unauthorized use without credit may be subject to removal.\n\nFor all business inquiries, questions, or copyright matters, please contact: [email protected]", "feature_image": "https://i.ytimg.com/vi/rNwuAZ7WLaI/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=rNwuAZ7WLaI" } ], "webcast_live": false, "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/cz-7a_launch_2_image_20251206093324.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7351, "location_launch_attempt_count": 69, "pad_launch_attempt_count": 32, "agency_launch_attempt_count": 606, "orbital_launch_attempt_count_year": 178, "location_launch_attempt_count_year": 14, "pad_launch_attempt_count_year": 4, "agency_launch_attempt_count_year": 36 }
