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/974b8306-fe0c-42a8-b415-73a7acc50b17/?format=api
{ "id": "974b8306-fe0c-42a8-b415-73a7acc50b17", "url": "https://ll.thespacedevs.com/2.2.0/launch/974b8306-fe0c-42a8-b415-73a7acc50b17/?format=api", "slug": "long-march-7-tianzhou-1", "flightclub_url": null, "r_spacex_api_id": null, "name": "Long March 7 | Tianzhou-1", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2024-08-02T17:03:29Z", "updates": [], "net": "2017-04-20T11:41:35Z", "net_precision": null, "window_end": "2017-04-20T11:41:35Z", "window_start": "2017-04-20T11:41:35Z", "probability": -1, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 88, "url": "https://ll.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": 517, "consecutive_successful_launches": 59, "successful_launches": 503, "failed_launches": 14, "pending_launches": 8, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://english.spacechina.com/", "wiki_url": "https://en.wikipedia.org/wiki/China_Aerospace_Science_and_Technology_Corporation", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_logo_20220826093937.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_image_20191228094408.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_nation_20230604193716.png" }, "rocket": { "id": 1997, "configuration": { "id": 100, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/100/?format=api", "name": "Long March 7", "active": true, "reusable": false, "description": "The Long March 7 is a Chinese liquid-fuelled launch vehicle of the Long March family, developed by the China Aerospace Science and Technology Corporation (CAST). It made its inaugural flight on 25 June 2016 and is used to launch Tianzhou resupply spacecraft to the Chinese Space Station.", "family": "Long March", "full_name": "Long March 7", "manufacturer": { "id": 88, "url": "https://ll.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": 517, "consecutive_successful_launches": 59, "successful_launches": 503, "failed_launches": 14, "pending_launches": 8, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://english.spacechina.com/", "wiki_url": "https://en.wikipedia.org/wiki/China_Aerospace_Science_and_Technology_Corporation", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_logo_20220826093937.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_image_20191228094408.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_nation_20230604193716.png" }, "program": [], "variant": "", "alias": "", "min_stage": 2, "max_stage": 2, "length": 53.1, "diameter": 3.35, "maiden_flight": "2016-06-25", "launch_cost": null, "launch_mass": null, "leo_capacity": 13500, "gto_capacity": 5500, "to_thrust": 7128, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long_march_7_image_20210513083007.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Long_March_7", "total_launch_count": 8, "consecutive_successful_launches": 8, "successful_launches": 8, "failed_launches": 0, "pending_launches": 1, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": { "id": 599, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/599/?format=api", "mission_end": "2017-09-22T10:00:00Z", "destination": "Tiangong-2", "launch_crew": [], "onboard_crew": [], "landing_crew": [], "spacecraft": { "id": 461, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/461/?format=api", "name": "Tianzhou-1", "serial_number": "1", "is_placeholder": false, "in_space": false, "time_in_space": "P154DT22H18M25S", "time_docked": "P154DT8H15M", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "First operational Tianzhou spacecraft. Launched to the Tiangong-2 space station.", "spacecraft_config": { "id": 25, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/25/?format=api", "name": "Tianzhou", "type": { "id": 4, "name": "Cargo Resupply" }, "agency": { "id": 88, "url": "https://ll.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": "", "parent": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_image_20191228094408.jpeg", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_logo_20220826093937.png" }, "in_use": true, "capability": "Cargo Earth Orbit Logistics", "history": "The Tianzhou is a Chinese automated cargo spacecraft that was first launched on April 20, 2017 to resupply Tiangong-1. It demonstrated autonomous propellant transfer in orbit.", "details": "Autonomous cargo spacecraft used to resupply the Chinese Space Station.", "maiden_flight": "2017-04-20", "height": 9.0, "diameter": 3.35, "human_rated": false, "crew_capacity": null, "payload_capacity": 6700, "payload_return_capacity": null, "flight_life": "180 days in orbit", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/tianzhou_image_20210513100807.jpg", "nation_url": null, "wiki_link": "https://en.wikipedia.org/wiki/Tianzhou_(spacecraft)", "info_link": "" } }, "landing": { "id": 1050, "attempt": false, "success": null, "description": "The Tianzhou-1 spacecraft burned up as planned upon entering Earth's atmosphere.", "downrange_distance": null, "location": null, "type": { "id": 7, "name": "Destructive Reentry", "abbrev": "ATM", "description": "Spacecraft burned up in the atmosphere" } }, "docking_events": [ { "id": 282, "spacestation": { "id": 8, "url": "https://ll.thespacedevs.com/2.2.0/spacestation/8/?format=api", "name": "Tiangong 2", "status": { "id": 2, "name": "De-Orbited" }, "founded": "2016-09-15", "description": "Tiangong-2 (Chinese: 天宫二号; pinyin: Tiāngōng èrhào; literally: \"Celestial Palace 2\") is a Chinese space laboratory and part of the Project 921-2 space station program. Tiangong-2 was launched on 15 September 2016.\r\n\r\nTiangong-2 is neither designed nor planned to be a permanent orbital station; rather, it is intended as a testbed for key technologies that will be used in the Chinese large modular space station, which is planned for launch between 2019 and 2022.", "orbit": "Low Earth Orbit", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/tiangong25202_image_20190215013232.jpeg" }, "docking": "2017-04-21T00:00:00Z", "departure": "2017-09-22T08:15:00Z", "docking_location": { "id": 31, "name": "Tiangong-2 forward", "spacestation": { "id": 8, "url": "https://ll.thespacedevs.com/2.2.0/spacestation/8/?format=api", "name": "Tiangong 2" } } } ] } }, "mission": { "id": 354, "name": "Tianzhou-1", "description": "Tianzhou 1 is the first Chinese uncrewed cargo spacecraft to service the Tiangong 2 and follow on space stations.", "launch_designator": null, "type": "Resupply", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 176, "url": "https://ll.thespacedevs.com/2.2.0/pad/176/?format=api", "agency_id": null, "name": "201", "description": "", "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://ll.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-prod.nyc3.digitaloceanspaces.com/media/map_images/location_8_20200803142445.jpg", "timezone_name": "Asia/Shanghai", "total_launch_count": 37, "total_landing_count": 0 }, "country_code": "CHN", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_176_20200803143412.jpg", "total_launch_count": 22, "orbital_launch_attempt_count": 22 }, "infoURLs": [], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "The Nostalgia 20170420 | CCTV-4", "description": "《探梦天宫》 20170420 中国首艘货运飞船天舟一号发射特别报道 | CCTV-4 百集大型纪录片《记住乡愁》以弘扬中华优秀传统文化为宗旨，选取100个以上的传统村落进行拍摄，是一部以看得见的古村落为载体，以生活化的故事为依托，以乡愁为情感基础，以优秀的传统文化为核心的大型纪录片。 《记住乡愁（第三季）》官方...", "feature_image": "https://i.ytimg.com/vi/HVtFFbSWGN4/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=HVtFFbSWGN4", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "360-degree view of Tianzhou-1 cargo spacecraft launch - blast off", "description": "China on Thursday launched its first cargo spacecraft, Tianzhou-1, into space. Lifted by a Long March-7 Y2 carrier rocket, Tianzhou-1 roared into the air fro...", "feature_image": "https://i.ytimg.com/vi/Z70tyeh0giE/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=Z70tyeh0giE", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "China launches first cargo spacecraft Tianzhou-1 天舟一号发射升空", "description": "#Live: China launches its first cargo spacecraft, Tianzhou-1 in Wenchang, Hainan. It's a crucial step for China in its goal of building a space station by th...", "feature_image": "https://i.ytimg.com/vi/_MnOslJRYS4/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=_MnOslJRYS4", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "China lanza su primer carguero espacial Tianzhou 1", "description": "El carguero será puesto en órbita por el cohete portador Chang Zheng 7, un nuevo desarrollo de cohetes orbitales lanzado por primera vez en julio de 2016. SE...", "feature_image": "https://i.ytimg.com/vi/eJKCLylTcuw/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=eJKCLylTcuw", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Live：正在直播 首位“快递小哥”天舟一号今晚“发货”", "description": "-------【Please subscribe to the SMG Official TV Channel! 欢迎订阅SMG上海电视台官方频道】天舟一号货运飞船计划4月20日晚在海南文昌航天发射场发射。今晚，中国航天的精兵强将们又将再一次吹响集结号。在海南文昌航天发射场，我国首个货运飞船天舟一号目前已经整装待...", "feature_image": "https://i.ytimg.com/vi/mUvmH0u0M2k/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=mUvmH0u0M2k", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "YouTube", "description": "", "feature_image": null, "url": "https://www.youtube.com/watch?v=n4yhYje78jU", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "China successfully launches its first cargo spacecraft Tianzhou-1", "description": "China's first cargo spacecraft Tianzhou-1 successfully entered orbit on Thursday evening local time, over 20 minutes after blasting off on the back of a Long...", "feature_image": "https://i.ytimg.com/vi/-DF2tST5Yp4/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=-DF2tST5Yp4", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long_march_7_image_20210513083007.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 5637, "location_launch_attempt_count": 3, "pad_launch_attempt_count": 2, "agency_launch_attempt_count": 194, "orbital_launch_attempt_count_year": 22, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 4, "pad_turnaround": "P298DT23H41M28S", "mission_patches": [], "type": "detailed" }
