Spacecraft List
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/?format=api&offset=586&ordering=id
https://lldev.thespacedevs.com/2.3.0/spacecraft/?format=api&limit=10&offset=576&ordering=id", "results": [ { "response_mode": "normal", "id": 609, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft/609/?format=api", "name": "Shenzhou 20", "serial_number": "20", "is_placeholder": false, "image": { "id": 1926, "name": "[AUTO] Shenzhou - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/shenzhou_image_20190207032522.jpeg", "thumbnail_url": "https://thespacedevs-prod.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": "P86DT16H24M8S", "time_docked": "P86DT9H52M39S", "flights_count": 1, "mission_ends_count": 0, "status": { "id": 1, "name": "Active" }, "description": "Spacecraft used to launch 3 astronauts on the 9th crewed mission to the Chinese Space Station.", "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-prod.nyc3.digitaloceanspaces.com/media/images/shenzhou_image_20190207032522.jpeg", "thumbnail_url": "https://thespacedevs-prod.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 }, { "response_mode": "normal", "id": 610, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft/610/?format=api", "name": "Shenzhou 21", "serial_number": "21", "is_placeholder": false, "image": { "id": 1926, "name": "[AUTO] Shenzhou - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/shenzhou_image_20190207032522.jpeg", "thumbnail_url": "https://thespacedevs-prod.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": false, "time_in_space": "P0D", "time_docked": "P0D", "flights_count": 0, "mission_ends_count": 0, "status": { "id": 1, "name": "Active" }, "description": "Spacecraft used to launch 3 astronauts on the 10th crewed mission to the Chinese Space Station.", "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-prod.nyc3.digitaloceanspaces.com/media/images/shenzhou_image_20190207032522.jpeg", "thumbnail_url": "https://thespacedevs-prod.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 }, { "response_mode": "normal", "id": 611, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft/611/?format=api", "name": "Tianzhou-9", "serial_number": "9", "is_placeholder": false, "image": { "id": 1937, "name": "[AUTO] Tianzhou - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/tianzhou_image_20210513100807.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194204.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "in_space": true, "time_in_space": "P5DT4H7M16S", "time_docked": "P5DT49M40S", "flights_count": 1, "mission_ends_count": 0, "status": { "id": 4, "name": "Single Use" }, "description": "Ninth operational Tianzhou spacecraft.", "spacecraft_config": { "response_mode": "normal", "id": 25, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft_configurations/25/?format=api", "name": "Tianzhou", "type": { "id": 4, "name": "Cargo Resupply" }, "agency": { "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" } }, "family": [], "in_use": true, "image": { "id": 1937, "name": "[AUTO] Tianzhou - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/tianzhou_image_20210513100807.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194204.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] } }, "fastest_turnaround": null }, { "response_mode": "normal", "id": 612, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft/612/?format=api", "name": "Soyuz MS-28", "serial_number": "11F732 #759", "is_placeholder": false, "image": { "id": 967, "name": "Soyuz MS in orbit (MS-19)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_ms_in_orb_image_20240313130407.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_ms_in_orb_image_thumbnail_20240313130407.jpeg", "credit": "ESA/NASA/T. Pesquet", "license": { "id": 2, "name": "ESA Standard Licence", "priority": 2, "link": "https://www.esa.int/ESA_Multimedia/Terms_and_conditions_of_use_of_images_and_videos_available_on_the_esa_website" }, "single_use": false, "variants": [] }, "in_space": false, "time_in_space": "P0D", "time_docked": "P0D", "flights_count": 0, "mission_ends_count": 0, "status": { "id": 1, "name": "Active" }, "description": "Soyuz capsule for the MS-28 mission to the ISS.", "spacecraft_config": { "response_mode": "normal", "id": 38, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft_configurations/38/?format=api", "name": "Soyuz MS", "type": { "id": 2, "name": "Capsule" }, "agency": { "response_mode": "list", "id": 63, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "abbrev": "RFSA", "type": { "id": 1, "name": "Government" } }, "family": [ { "response_mode": "normal", "id": 1, "name": "Soyuz", "description": "Soyuz is a series of spacecraft which has been in service since the 1960s, having made more than 140 flights. It was designed for the Soviet space program by the Korolev Design Bureau (now Energia).", "manufacturer": { "response_mode": "list", "id": 1000, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1000/?format=api", "name": "Energia", "abbrev": "OKB-1", "type": { "id": 1, "name": "Government" } }, "parent": null, "maiden_flight": "1966-11-28" } ], "in_use": true, "image": { "id": 967, "name": "Soyuz MS in orbit (MS-19)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_ms_in_orb_image_20240313130407.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_ms_in_orb_image_thumbnail_20240313130407.jpeg", "credit": "ESA/NASA/T. Pesquet", "license": { "id": 2, "name": "ESA Standard Licence", "priority": 2, "link": "https://www.esa.int/ESA_Multimedia/Terms_and_conditions_of_use_of_images_and_videos_available_on_the_esa_website" }, "single_use": false, "variants": [] } }, "fastest_turnaround": null }, { "response_mode": "normal", "id": 613, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft/613/?format=api", "name": "Gaganyaan G3", "serial_number": null, "is_placeholder": false, "image": { "id": 1914, "name": "[AUTO] Gaganyaan - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/gaganyaan_image_20231021132705.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194125.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "in_space": false, "time_in_space": "P0D", "time_docked": "P0D", "flights_count": 0, "mission_ends_count": 0, "status": { "id": 4, "name": "Single Use" }, "description": "Third operational Gaganyaan capsule.", "spacecraft_config": { "response_mode": "normal", "id": 29, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft_configurations/29/?format=api", "name": "Gaganyaan", "type": { "id": 2, "name": "Capsule" }, "agency": { "response_mode": "list", "id": 1031, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1031/?format=api", "name": "Hindustan Aeronautics Limited", "abbrev": "HAL", "type": { "id": 1, "name": "Government" } }, "family": [], "in_use": true, "image": { "id": 1914, "name": "[AUTO] Gaganyaan - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/gaganyaan_image_20231021132705.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194125.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] } }, "fastest_turnaround": null }, { "response_mode": "normal", "id": 614, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft/614/?format=api", "name": "Ship 35", "serial_number": "S35", "is_placeholder": false, "image": { "id": 1935, "name": "[AUTO] Starship - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/starship_image_20231116184708.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194201.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "in_space": false, "time_in_space": "PT47M18S", "time_docked": "P0D", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 3, "name": "Destroyed" }, "description": "Ship 35 (S35) is the 2nd stage vehicle used for the ninth Starship flight test. It is the third \"Block 2\" Starship spacecraft with lengthened propellant tanks and forward flaps with a new design, among other enhancements. The spacecraft lost attitude control during its sub-orbital flight and burnt up during re-entry.", "spacecraft_config": { "response_mode": "normal", "id": 26, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft_configurations/26/?format=api", "name": "Starship", "type": { "id": 6, "name": "Reuseable Upper Stage" }, "agency": { "response_mode": "list", "id": 121, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/121/?format=api", "name": "SpaceX", "abbrev": "SpX", "type": { "id": 3, "name": "Commercial" } }, "family": [], "in_use": true, "image": { "id": 1935, "name": "[AUTO] Starship - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/starship_image_20231116184708.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194201.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] } }, "fastest_turnaround": null }, { "response_mode": "normal", "id": 615, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft/615/?format=api", "name": "Ship 36", "serial_number": "S36", "is_placeholder": false, "image": { "id": 1935, "name": "[AUTO] Starship - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/starship_image_20231116184708.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194201.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "in_space": false, "time_in_space": "P0D", "time_docked": "P0D", "flights_count": 0, "mission_ends_count": 0, "status": { "id": 3, "name": "Destroyed" }, "description": "Ship 36 (S36) was the 2nd stage vehicle that was planned to be used for the 10th Starship flight test. It was the 4th \"Block 2\" Starship spacecraft with lengthened propellant tanks and forward flaps with a new design, among other enhancements. Destroyed in an explosion while attempting a static fire on the ground on 18 June 2025.", "spacecraft_config": { "response_mode": "normal", "id": 26, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft_configurations/26/?format=api", "name": "Starship", "type": { "id": 6, "name": "Reuseable Upper Stage" }, "agency": { "response_mode": "list", "id": 121, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/121/?format=api", "name": "SpaceX", "abbrev": "SpX", "type": { "id": 3, "name": "Commercial" } }, "family": [], "in_use": true, "image": { "id": 1935, "name": "[AUTO] Starship - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/starship_image_20231116184708.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194201.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] } }, "fastest_turnaround": null }, { "response_mode": "normal", "id": 616, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft/616/?format=api", "name": "Soyuz MS-29", "serial_number": "11F732 #760", "is_placeholder": false, "image": { "id": 967, "name": "Soyuz MS in orbit (MS-19)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_ms_in_orb_image_20240313130407.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_ms_in_orb_image_thumbnail_20240313130407.jpeg", "credit": "ESA/NASA/T. Pesquet", "license": { "id": 2, "name": "ESA Standard Licence", "priority": 2, "link": "https://www.esa.int/ESA_Multimedia/Terms_and_conditions_of_use_of_images_and_videos_available_on_the_esa_website" }, "single_use": false, "variants": [] }, "in_space": false, "time_in_space": "P0D", "time_docked": "P0D", "flights_count": 0, "mission_ends_count": 0, "status": { "id": 4, "name": "Single Use" }, "description": "Soyuz capsule for the MS-29 mission to the ISS.", "spacecraft_config": { "response_mode": "normal", "id": 38, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft_configurations/38/?format=api", "name": "Soyuz MS", "type": { "id": 2, "name": "Capsule" }, "agency": { "response_mode": "list", "id": 63, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "abbrev": "RFSA", "type": { "id": 1, "name": "Government" } }, "family": [ { "response_mode": "normal", "id": 1, "name": "Soyuz", "description": "Soyuz is a series of spacecraft which has been in service since the 1960s, having made more than 140 flights. It was designed for the Soviet space program by the Korolev Design Bureau (now Energia).", "manufacturer": { "response_mode": "list", "id": 1000, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1000/?format=api", "name": "Energia", "abbrev": "OKB-1", "type": { "id": 1, "name": "Government" } }, "parent": null, "maiden_flight": "1966-11-28" } ], "in_use": true, "image": { "id": 967, "name": "Soyuz MS in orbit (MS-19)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_ms_in_orb_image_20240313130407.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_ms_in_orb_image_thumbnail_20240313130407.jpeg", "credit": "ESA/NASA/T. Pesquet", "license": { "id": 2, "name": "ESA Standard Licence", "priority": 2, "link": "https://www.esa.int/ESA_Multimedia/Terms_and_conditions_of_use_of_images_and_videos_available_on_the_esa_website" }, "single_use": false, "variants": [] } }, "fastest_turnaround": null }, { "response_mode": "normal", "id": 617, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft/617/?format=api", "name": "Progress MS-31", "serial_number": "MS-31 (No.461)", "is_placeholder": false, "image": { "id": 1924, "name": "[AUTO] Progress-MS - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/progress-ms_image_20231219150735.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194142.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "in_space": true, "time_in_space": "P16DT6H9M", "time_docked": "P14DT4H16M41S", "flights_count": 1, "mission_ends_count": 0, "status": { "id": 4, "name": "Single Use" }, "description": "Progress MS-31 is a Progress spacecraft used by Roscosmos to resupply the International Space Station (ISS).", "spacecraft_config": { "response_mode": "normal", "id": 33, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft_configurations/33/?format=api", "name": "Progress-MS", "type": { "id": 4, "name": "Cargo Resupply" }, "agency": { "response_mode": "list", "id": 63, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "abbrev": "RFSA", "type": { "id": 1, "name": "Government" } }, "family": [ { "response_mode": "normal", "id": 2, "name": "Progress", "description": "The Progress is a Russian expendable cargo spacecraft. Its purpose is to deliver the supplies needed to sustain a human presence in orbit.", "manufacturer": { "response_mode": "list", "id": 1000, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1000/?format=api", "name": "Energia", "abbrev": "OKB-1", "type": { "id": 1, "name": "Government" } }, "parent": null, "maiden_flight": "1978-01-20" } ], "in_use": true, "image": { "id": 1924, "name": "[AUTO] Progress-MS - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/progress-ms_image_20231219150735.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194142.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] } }, "fastest_turnaround": null }, { "response_mode": "normal", "id": 618, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft/618/?format=api", "name": "Ship 37", "serial_number": "S37", "is_placeholder": false, "image": { "id": 1935, "name": "[AUTO] Starship - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/starship_image_20231116184708.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194201.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "in_space": false, "time_in_space": "P0D", "time_docked": "P0D", "flights_count": 0, "mission_ends_count": 0, "status": { "id": 1, "name": "Active" }, "description": "Ship 37 (S37) is the 2nd stage vehicle that was planned to be used for the 10th Starship flight test. It is the 5th \"Block 2\" Starship spacecraft with lengthened propellant tanks and forward flaps with a new design, among other enhancements.", "spacecraft_config": { "response_mode": "normal", "id": 26, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft_configurations/26/?format=api", "name": "Starship", "type": { "id": 6, "name": "Reuseable Upper Stage" }, "agency": { "response_mode": "list", "id": 121, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/121/?format=api", "name": "SpaceX", "abbrev": "SpX", "type": { "id": 3, "name": "Commercial" } }, "family": [], "in_use": true, "image": { "id": 1935, "name": "[AUTO] Starship - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/starship_image_20231116184708.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194201.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] } }, "fastest_turnaround": null } ] }{ "count": 596, "next": null, "previous": "