Spacecraft Instance
Modes
Levels of detail in the response - normal, detailed
Example - /spacecraft/?mode=detailed
Filters
Parameters - in_space, is_placeholder, name, spacecraft_config, status
Example - /spacecraft/?is_placeholder=True
Search
Fields searched - name, spacecraft_config__name
Example - /spacecraft/?search=Endeavour
Ordering
Fields - flights_count, id, mission_ends_count, time_docked, time_in_space
Example - /spacecraft/?ordering=-flights_count
Number of results
Use limit to control the number of objects in the response (max 100)
Example - /spacecraft/?limit=2
Format
Switch to JSON output - /spacecraft/?format=json
Help
Find all the FAQs and support links on the documentation homepage - lldev.thespacedevs.com/docs
GET /2.3.0/spacecraft/624/?format=api
{ "response_mode": "detailed", "id": 624, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft/624/?format=api", "name": "Shenzhou 22", "serial_number": "22", "is_placeholder": false, "image": { "id": 1926, "name": "[AUTO] Shenzhou - image", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/shenzhou_image_20190207032522.jpeg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194145.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "in_space": true, "time_in_space": "P11DT22H5M6S", "time_docked": "P11DT18H26M51S", "flights_count": 1, "mission_ends_count": 0, "status": { "id": 1, "name": "Active" }, "description": "Spacecraft to be launched without crew to replace Shenzhou 20 that was damaged by orbital debris on the descent module porthole window, and thus deemed unsuitable for crew re-entry. The spacecraft will later return three Chinese astronauts on the 10th flight to the Chinese Space Station back to Earth, after launching on Shenzhou 21.", "spacecraft_config": { "response_mode": "detailed", "id": 2, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft_configurations/2/?format=api", "name": "Shenzhou", "type": { "id": 2, "name": "Capsule" }, "agency": { "response_mode": "normal", "id": 17, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/17/?format=api", "name": "China National Space Administration", "abbrev": "CNSA", "type": { "id": 1, "name": "Government" }, "featured": true, "country": [ { "id": 6, "name": "China", "alpha_2_code": "CN", "alpha_3_code": "CHN", "nationality_name": "Chinese", "nationality_name_composed": "Sino" } ], "description": "The China National Space Administration (CNSA) is the national space agency of the People's Republic of China. It is responsible for the national space program and for planning and development of space activities. CNSA and China Aerospace Corporation (CASC) assumed the authority over space development efforts previously held by the Ministry of Aerospace Industry. The CNSA has many launch sites around China with their orbital sites located in Jiuquan, Xichang, Taiyuan and Wenchang.", "administrator": "Administrator: Tang Dengjie", "founding_year": 1993, "launchers": "", "spacecraft": "Shenzhou", "parent": null, "image": { "id": 9, "name": "[AUTO] China National Space Administration - image", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520national2520space2520administration_image_20190207032431.jpeg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184601.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 125, "name": "[AUTO] China National Space Administration - logo", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520national2520space2520administration_logo_20190207032431.png", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184936.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 51, "name": "[AUTO] China National Space Administration - social_logo", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520national2520space2520administration_nation_20190602114400.png", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184747.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] } }, "family": [], "in_use": true, "image": { "id": 1926, "name": "[AUTO] Shenzhou - image", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/shenzhou_image_20190207032522.jpeg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194145.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "capability": "Chinese crewed spaceflight program.", "history": "Shenzhou is a spacecraft used to support the Chinese manned spaceflight program and to carry crew to the Tiangong Space Station. Its design resembles the Russian Soyuz spacecraft, but it is larger in size and all-new in construction. The first launch was on November 19, 1999 and the first manned launch was on October 15, 2003.", "details": "The Shenzhou spacecraft resembles the Soyuz, although it is longer, with a larger habitable volume. It features a powered service module like the Soyuz, and prior to Shenzhou 8 its orbital module was capable of autonomous flight. \r\n\r\nThe aft service module contains life support and other equipment required for the functioning of Shenzhou.", "maiden_flight": "1999-11-19", "height": 9.25, "diameter": 2.8, "human_rated": true, "crew_capacity": 3, "payload_capacity": null, "payload_return_capacity": null, "flight_life": "200 day design life.", "wiki_link": "https://en.wikipedia.org/wiki/Shenzhou_(spacecraft)", "info_link": "", "spacecraft_flown": 22, "total_launch_count": 22, "successful_launches": 22, "failed_launches": 0, "attempted_landings": 20, "successful_landings": 19, "failed_landings": 1, "fastest_turnaround": null }, "fastest_turnaround": null, "flights": [ { "id": 900, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft_flights/900/?format=api", "destination": "Tiangong space station", "mission_end": null, "spacecraft": { "response_mode": "normal", "id": 624, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft/624/?format=api", "name": "Shenzhou 22", "serial_number": "22", "is_placeholder": false, "image": { "id": 1926, "name": "[AUTO] Shenzhou - image", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/shenzhou_image_20190207032522.jpeg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194145.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "in_space": true, "time_in_space": "P11DT22H5M6S", "time_docked": "P11DT18H26M51S", "flights_count": 1, "mission_ends_count": 0, "status": { "id": 1, "name": "Active" }, "description": "Spacecraft to be launched without crew to replace Shenzhou 20 that was damaged by orbital debris on the descent module porthole window, and thus deemed unsuitable for crew re-entry. The spacecraft will later return three Chinese astronauts on the 10th flight to the Chinese Space Station back to Earth, after launching on Shenzhou 21.", "spacecraft_config": { "response_mode": "normal", "id": 2, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft_configurations/2/?format=api", "name": "Shenzhou", "type": { "id": 2, "name": "Capsule" }, "agency": { "response_mode": "list", "id": 17, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/17/?format=api", "name": "China National Space Administration", "abbrev": "CNSA", "type": { "id": 1, "name": "Government" } }, "family": [], "in_use": true, "image": { "id": 1926, "name": "[AUTO] Shenzhou - image", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/shenzhou_image_20190207032522.jpeg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194145.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] } }, "fastest_turnaround": null }, "launch": { "id": "6da58dd3-57bf-4c0a-a003-c56268db3e59", "url": "https://lldev.thespacedevs.com/2.3.0/launches/6da58dd3-57bf-4c0a-a003-c56268db3e59/?format=api", "name": "Long March 2F/G | Shenzhou 22", "response_mode": "normal", "slug": "long-march-2fg-shenzhou-22", "launch_designator": "2025-272", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2025-11-25T14:57:41Z", "net": "2025-11-25T04:11:45Z", "net_precision": { "id": 0, "name": "Second", "abbrev": "SEC", "description": "The T-0 is accurate to the second." }, "window_end": "2025-11-25T04:41:00Z", "window_start": "2025-11-25T04:01:00Z", "image": { "id": 2580, "name": "Shenzhou 22 launch", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/shenzhou_22_lau_image_20251129175823.jpg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/shenzhou_22_lau_image_thumbnail_20251129175823.jpeg", "credit": "Xinhua", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "infographic": null, "probability": null, "weather_concerns": null, "failreason": "", "hashtag": null, "launch_service_provider": { "response_mode": "list", "id": 88, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/88/?format=api", "name": "China Aerospace Science and Technology Corporation", "abbrev": "CASC", "type": { "id": 1, "name": "Government" } }, "rocket": { "id": 8806, "configuration": { "response_mode": "list", "id": 84, "url": "https://lldev.thespacedevs.com/2.3.0/launcher_configurations/84/?format=api", "name": "Long March 2F/G", "families": [ { "response_mode": "list", "id": 106, "name": "Long March" }, { "response_mode": "list", "id": 109, "name": "Long March 2" } ], "full_name": "Long March 2F/G", "variant": "F/G" } }, "mission": { "id": 7397, "name": "Shenzhou 22", "type": "Human Exploration", "description": "Shenzhou 22 (Chinese: 神舟二十二号) will be the 22nd flight of the Shenzhou program. The spacecraft will be launched without crew to replace Shenzhou 20 that was damaged by orbital debris on the descent module porthole window, and thus deemed unsuitable for crew re-entry. The spacecraft will later return three Chinese astronauts on the 10th flight to the Chinese Space Station back to Earth, after launching on Shenzhou 21.", "image": null, "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO", "celestial_body": { "response_mode": "list", "id": 1, "name": "Earth" } }, "agencies": [ { "response_mode": "normal", "id": 17, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/17/?format=api", "name": "China National Space Administration", "abbrev": "CNSA", "type": { "id": 1, "name": "Government" }, "featured": true, "country": [ { "id": 6, "name": "China", "alpha_2_code": "CN", "alpha_3_code": "CHN", "nationality_name": "Chinese", "nationality_name_composed": "Sino" } ], "description": "The China National Space Administration (CNSA) is the national space agency of the People's Republic of China. It is responsible for the national space program and for planning and development of space activities. CNSA and China Aerospace Corporation (CASC) assumed the authority over space development efforts previously held by the Ministry of Aerospace Industry. The CNSA has many launch sites around China with their orbital sites located in Jiuquan, Xichang, Taiyuan and Wenchang.", "administrator": "Administrator: Tang Dengjie", "founding_year": 1993, "launchers": "", "spacecraft": "Shenzhou", "parent": null, "image": { "id": 9, "name": "[AUTO] China National Space Administration - image", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520national2520space2520administration_image_20190207032431.jpeg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184601.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 125, "name": "[AUTO] China National Space Administration - logo", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520national2520space2520administration_logo_20190207032431.png", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184936.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 51, "name": "[AUTO] China National Space Administration - social_logo", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520national2520space2520administration_nation_20190602114400.png", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184747.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 2, "consecutive_successful_launches": 2, "successful_launches": 2, "failed_launches": 0, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "successful_landings_spacecraft": 19, "failed_landings_spacecraft": 1, "attempted_landings_spacecraft": 20, "successful_landings_payload": 2, "failed_landings_payload": 0, "attempted_landings_payload": 2, "info_url": "https://www.cnsa.gov.cn/", "wiki_url": "https://en.wikipedia.org/wiki/China_National_Space_Administration", "social_media_links": [] } ], "info_urls": [], "vid_urls": [] }, "pad": { "id": 37, "url": "https://lldev.thespacedevs.com/2.3.0/pads/37/?format=api", "active": true, "agencies": [], "name": "Launch Area 91 (SLS-1 / 921)", "image": { "id": 1363, "name": "Long March 2F/G from LA-4 (Shenzhou 17)", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/long2520march_image_20231231163528.jpeg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192527.jpeg", "credit": "我们的太空", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": false, "variants": [] }, "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Jiuquan_Launch_Area_4", "map_url": "https://www.google.com/maps?q=40.957893,100.290944", "latitude": 40.957893, "longitude": 100.290944, "country": { "id": 6, "name": "China", "alpha_2_code": "CN", "alpha_3_code": "CHN", "nationality_name": "Chinese", "nationality_name_composed": "Sino" }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_37_20200803143603.jpg", "total_launch_count": 27, "orbital_launch_attempt_count": 27, "fastest_turnaround": "P24DT12H26M59S", "location": { "response_mode": "normal", "id": 17, "url": "https://lldev.thespacedevs.com/2.3.0/locations/17/?format=api", "name": "Jiuquan Satellite Launch Center, People's Republic of China", "celestial_body": { "response_mode": "normal", "id": 1, "name": "Earth", "type": { "id": 1, "name": "Planet" }, "diameter": 12742000.0, "mass": 5.972168e+24, "gravity": 9.80655, "length_of_day": "1 00:00:00", "atmosphere": true, "image": { "id": 2040, "name": "Earth (Apollo 17)", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_20240402194304.jpeg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_thumbnail_20240402194305.jpeg", "credit": "NASA", "license": { "id": 4, "name": "NASA Image and Media Guidelines", "priority": 0, "link": "https://www.nasa.gov/nasa-brand-center/images-and-media/" }, "single_use": true, "variants": [] }, "description": "Earth is the third planet from the Sun and the only astronomical object known to harbor life.", "wiki_url": "https://en.wikipedia.org/wiki/Earth", "total_attempted_launches": 7358, "successful_launches": 6810, "failed_launches": 548, "total_attempted_landings": 1230, "successful_landings": 1184, "failed_landings": 46 }, "active": true, "country": { "id": 6, "name": "China", "alpha_2_code": "CN", "alpha_3_code": "CHN", "nationality_name": "Chinese", "nationality_name_composed": "Sino" }, "description": "Jiuquan Satellite Launch Center is a Chinese spaceport located between the Ejin, Alxa, Inner Mongolia and Hangtian Town, Jinta County, Jiuquan, Gansu Province. It is part of the Dongfeng Aerospace City (Base 10).", "image": { "id": 1374, "name": "Long March 2F/G liftoff (Shenzhou 16)", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/long2520march_image_20240101085213.jpeg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192548.jpeg", "credit": "CMS", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": false, "variants": [] }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_17_20200803142429.jpg", "longitude": 100.291111, "latitude": 40.958056, "timezone_name": "Asia/Shanghai", "total_launch_count": 268, "total_landing_count": 1 } }, "webcast_live": false, "program": [ { "response_mode": "normal", "id": 19, "url": "https://lldev.thespacedevs.com/2.3.0/programs/19/?format=api", "name": "Tiangong space station", "image": { "id": 1893, "name": "[AUTO] Tiangong space station - image", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/chinese2520spa_program_20210608105528.png", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194050.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Tiangong_space_station", "description": "The Tiangong space station is a space station placed in Low Earth orbit between 340 and 450 km above the surface.", "agencies": [ { "response_mode": "list", "id": 88, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/88/?format=api", "name": "China Aerospace Science and Technology Corporation", "abbrev": "CASC", "type": { "id": 1, "name": "Government" } } ], "start_date": "2021-04-29T03:23:00Z", "end_date": null, "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } }, { "response_mode": "normal", "id": 7, "url": "https://lldev.thespacedevs.com/2.3.0/programs/7/?format=api", "name": "Shenzhou", "image": { "id": 1888, "name": "[AUTO] Shenzhou - image", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/shenzhou_program_20200820204745.PNG", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194040.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Shenzhou_program", "description": "The Shenzhou program is a crewed spaceflight initiative by China. The program put the first Chinese citizen, Yang Liwei, into orbit on 15 October 2003.", "agencies": [ { "response_mode": "list", "id": 17, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/17/?format=api", "name": "China National Space Administration", "abbrev": "CNSA", "type": { "id": 1, "name": "Government" } } ], "start_date": "1993-01-01T00:00:00Z", "end_date": null, "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": 7128, "location_launch_attempt_count": 266, "pad_launch_attempt_count": 27, "agency_launch_attempt_count": 557, "orbital_launch_attempt_count_year": 279, "location_launch_attempt_count_year": 27, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 56 }, "landing": { "id": 1738, "url": "https://lldev.thespacedevs.com/2.3.0/landings/1738/?format=api", "attempt": true, "success": null, "description": "The Shenzhou 22 spacecraft will land at the Donfgeng landing site in Inner Mongolia, China.", "downrange_distance": null, "landing_location": { "id": 22, "name": "Dongfeng Landing Site", "active": true, "abbrev": "DLS", "description": "Dongfeng landing site in the Gobi Desert, North China's Inner Mongolia Autonomous Region.", "location": null, "longitude": null, "latitude": null, "image": { "id": 1260, "name": "[AUTO] Shenzhou 16 Landing - image", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/shenzhou_16_lan_image_20231027084649.jpeg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192204.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "successful_landings": 9, "attempted_landings": 9, "failed_landings": 0, "celestial_body": { "response_mode": "normal", "id": 1, "name": "Earth", "type": { "id": 1, "name": "Planet" }, "diameter": 12742000.0, "mass": 5.972168e+24, "gravity": 9.80655, "length_of_day": "1 00:00:00", "atmosphere": true, "image": { "id": 2040, "name": "Earth (Apollo 17)", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_20240402194304.jpeg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_thumbnail_20240402194305.jpeg", "credit": "NASA", "license": { "id": 4, "name": "NASA Image and Media Guidelines", "priority": 0, "link": "https://www.nasa.gov/nasa-brand-center/images-and-media/" }, "single_use": true, "variants": [] }, "description": "Earth is the third planet from the Sun and the only astronomical object known to harbor life.", "wiki_url": "https://en.wikipedia.org/wiki/Earth" } }, "type": { "id": 4, "name": "Parachute Landing", "abbrev": "PCL", "description": "Unpowered landing using parachute(s)." } }, "duration": "P11DT22H8M59.816881S", "turn_around_time": null, "response_mode": "normal" } ] }
