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=590&ordering=-mission_ends_count
{ "count": 596, "next": null, "previous": "https://lldev.thespacedevs.com/2.3.0/spacecraft/?format=api&limit=10&offset=580&ordering=-mission_ends_count", "results": [ { "response_mode": "normal", "id": 608, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft/608/?format=api", "name": "Unknown RSS", "serial_number": "TBD", "is_placeholder": false, "image": { "id": 2152, "name": "New Shepard Crew Capsule Jules Verne under parachutes", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/new_shepard_cre_image_20240812144851.jpg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/new_shepard_cre_image_thumbnail_20240812144851.jpeg", "credit": "Blue Origin", "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": "The specific spacecraft for this launch is currently unknown.", "spacecraft_config": { "response_mode": "normal", "id": 21, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft_configurations/21/?format=api", "name": "Crew Capsule 2.0", "type": { "id": 2, "name": "Capsule" }, "agency": { "response_mode": "list", "id": 141, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/141/?format=api", "name": "Blue Origin", "abbrev": "BO", "type": { "id": 3, "name": "Commercial" } }, "family": [ { "response_mode": "normal", "id": 5, "name": "New Shepard Crew Capsule", "description": "Capsules built for suborbital human spaceflight on New Shepard", "manufacturer": { "response_mode": "list", "id": 141, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/141/?format=api", "name": "Blue Origin", "abbrev": "BO", "type": { "id": 3, "name": "Commercial" } }, "parent": null, "maiden_flight": "2015-04-29" } ], "in_use": true, "image": { "id": 1907, "name": "New Shepard M7 H. G. Wells landed", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/crew2520capsule25202.0_image_20190309095011.jpeg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194115.jpeg", "credit": "Blue Origin", "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-dev.nyc3.digitaloceanspaces.com/media/images/tianzhou_image_20210513100807.jpg", "thumbnail_url": "https://thespacedevs-dev.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": "P54DT4H26M33S", "time_docked": "P54DT1H8M56S", "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-dev.nyc3.digitaloceanspaces.com/media/images/tianzhou_image_20210513100807.jpg", "thumbnail_url": "https://thespacedevs-dev.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": 470, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft/470/?format=api", "name": "Ship 20", "serial_number": "S20", "is_placeholder": false, "image": { "id": 1935, "name": "[AUTO] Starship - image", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/starship_image_20231116184708.jpeg", "thumbnail_url": "https://thespacedevs-dev.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": 2, "name": "Retired" }, "description": "Used for ground testing alongside Booster 4. Ship 20 is now on display at the Starbase Rocket Garden.", "spacecraft_config": { "response_mode": "normal", "id": 26, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft_configurations/26/?format=api", "name": "Starship V1", "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": [ { "response_mode": "normal", "id": 8, "name": "Starship", "description": "SpaceX Starship upper stages family", "manufacturer": { "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" } }, "parent": null, "maiden_flight": "2023-04-20" } ], "in_use": false, "image": { "id": 1935, "name": "[AUTO] Starship - image", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/starship_image_20231116184708.jpeg", "thumbnail_url": "https://thespacedevs-dev.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": 275, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft/275/?format=api", "name": "Tesla Roadster", "serial_number": "TSLA 10", "is_placeholder": false, "image": { "id": 1936, "name": "Tesla Roadster and Starman", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/tesla2520roadster_image_20190307220553.jpg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194202.jpeg", "credit": "SpaceX", "license": { "id": 5, "name": "CC BY-NC 2.0", "priority": 1, "link": "https://creativecommons.org/licenses/by-nc/2.0/" }, "single_use": true, "variants": [] }, "in_space": true, "time_in_space": "P2769DT5H13M33S", "time_docked": "P0D", "flights_count": 1, "mission_ends_count": 0, "status": { "id": 4, "name": "Single Use" }, "description": "Elon Musk's Tesla Roadster is an electric sports car that served as the dummy payload for the February 2018 Falcon Heavy test flight and became an artificial satellite of the Sun. \"Starman\", a mannequin dressed in a spacesuit, occupies the driver's seat. The car and rocket are products of Tesla and SpaceX, respectively, both companies founded by Elon Musk. The 2008-model Roadster was previously used by Musk for commuting to work, and is the only production car in space.\r\n\r\nThe car, mounted on the rocket's second stage, acquired enough velocity to escape Earth's gravity and enter an elliptical heliocentric orbit crossing the orbit of Mars. The orbit reaches a maximum distance from the Sun at aphelion of 1.66 astronomical units (au). During the early portion of the voyage outside the Earth's atmosphere, live video was transmitted back to the mission control center and live-streamed for slightly over four hours.", "spacecraft_config": { "response_mode": "normal", "id": 20, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft_configurations/20/?format=api", "name": "Tesla Roadster", "type": { "id": 5, "name": "Mass Simulator" }, "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": false, "image": { "id": 1936, "name": "Tesla Roadster and Starman", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/tesla2520roadster_image_20190307220553.jpg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194202.jpeg", "credit": "SpaceX", "license": { "id": 5, "name": "CC BY-NC 2.0", "priority": 1, "link": "https://creativecommons.org/licenses/by-nc/2.0/" }, "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-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": 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-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 }, { "response_mode": "normal", "id": 443, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft/443/?format=api", "name": "X-15-2", "serial_number": "56-6671", "is_placeholder": false, "image": { "id": 1918, "name": "[AUTO] North American X-15 - image", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/north2520american2520x-15_image_20190207032520.jpeg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194132.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": 2, "name": "Retired" }, "description": "Second X-15 experimental rocket plane.", "spacecraft_config": { "response_mode": "normal", "id": 13, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft_configurations/13/?format=api", "name": "North American X-15", "type": { "id": 3, "name": "Spaceplane" }, "agency": { "response_mode": "list", "id": 44, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "abbrev": "NASA", "type": { "id": 1, "name": "Government" } }, "family": [], "in_use": false, "image": { "id": 1918, "name": "[AUTO] North American X-15 - image", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/north2520american2520x-15_image_20190207032520.jpeg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194132.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] } }, "fastest_turnaround": null } ] }
