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 - ll.thespacedevs.com/docs
GET /2.3.0/spacecraft/533/?format=api
{ "response_mode": "detailed", "id": 533, "url": "https://ll.thespacedevs.com/2.3.0/spacecraft/533/?format=api", "name": "Vostok-1K No.4", "serial_number": "Vostok-1K No.4", "is_placeholder": false, "image": { "id": 1939, "name": "[AUTO] Vostok - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vostok-3ka_image_20190207032525.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194207.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": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "Vostok spacecraft used for test flights before the first human spaceflight.", "spacecraft_config": { "response_mode": "detailed", "id": 15, "url": "https://ll.thespacedevs.com/2.3.0/spacecraft_configurations/15/?format=api", "name": "Vostok", "type": { "id": 2, "name": "Capsule" }, "agency": { "response_mode": "normal", "id": 63, "url": "https://ll.thespacedevs.com/2.3.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "abbrev": "RFSA", "type": { "id": 1, "name": "Government" }, "featured": true, "country": [ { "id": 5, "name": "Russia", "alpha_2_code": "RU", "alpha_3_code": "RUS", "nationality_name": "Russian", "nationality_name_composed": "Russo" } ], "description": "The Roscosmos State Corporation for Space Activities, commonly known as Roscosmos, is the governmental body responsible for the space science program of the Russian Federation and general aerospace research. Soyuz has many launch locations the Russian sites are Baikonur, Plesetsk and Vostochny however Ariane also purchases the vehicle and launches it from French Guiana.", "administrator": "Administrator: Yuri Borisov", "founding_year": 1992, "launchers": "Soyuz", "spacecraft": "Soyuz", "parent": null, "image": { "id": 25, "name": "[AUTO] Russian Federal Space Agency (ROSCOSMOS) - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_image_20190207032459.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184652.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 177, "name": "[AUTO] Russian Federal Space Agency (ROSCOSMOS) - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_logo_20190207032459.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185118.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 89, "name": "[AUTO] Russian Federal Space Agency (ROSCOSMOS) - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_nation_20230531052758.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184841.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] } }, "family": [], "in_use": false, "image": { "id": 1939, "name": "[AUTO] Vostok - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vostok-3ka_image_20190207032525.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194207.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "capability": "Human spaceflight in LEO.", "history": "The Vostok (Russian: Восток, translated as \"East\") was a type of spacecraft built by the Soviet Union. The spacecraft was part of the Vostok programme, in which six manned spaceflights were made, from 1961–63.", "details": "The Vostok-3KA consisted of a spherical descent module, which housed the cosmonaut, instruments and escape system, and a conical instrument module, which contained propellant and the engine system. \r\n\r\nOn reentry, the cosmonaut would eject from the craft at about 7,000 m (23,000 ft) and descend via parachute, while the capsule would land separately. The reason for this was that the Vostok descent module made an extremely rough landing that could have left a cosmonaut seriously injured.", "maiden_flight": "1960-05-15", "height": 4.55, "diameter": 2.43, "human_rated": true, "crew_capacity": 1, "payload_capacity": 4725, "payload_return_capacity": null, "flight_life": "Longest flight was 4 days.", "wiki_link": "https://en.wikipedia.org/wiki/Vostok_(spacecraft)", "info_link": "", "spacecraft_flown": 13, "total_launch_count": 13, "successful_launches": 11, "failed_launches": 2, "attempted_landings": 11, "successful_landings": 10, "failed_landings": 1, "fastest_turnaround": null }, "fastest_turnaround": null, "flights": [ { "id": 750, "url": "https://ll.thespacedevs.com/2.3.0/spacecraft_flights/750/?format=api", "destination": "Low Earth Orbit", "mission_end": "1960-12-22T07:45:19Z", "spacecraft": { "response_mode": "normal", "id": 533, "url": "https://ll.thespacedevs.com/2.3.0/spacecraft/533/?format=api", "name": "Vostok-1K No.4", "serial_number": "Vostok-1K No.4", "is_placeholder": false, "image": { "id": 1939, "name": "[AUTO] Vostok - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vostok-3ka_image_20190207032525.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194207.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": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "Vostok spacecraft used for test flights before the first human spaceflight.", "spacecraft_config": { "response_mode": "normal", "id": 15, "url": "https://ll.thespacedevs.com/2.3.0/spacecraft_configurations/15/?format=api", "name": "Vostok", "type": { "id": 2, "name": "Capsule" }, "agency": { "response_mode": "list", "id": 63, "url": "https://ll.thespacedevs.com/2.3.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "abbrev": "RFSA", "type": { "id": 1, "name": "Government" } }, "family": [], "in_use": false, "image": { "id": 1939, "name": "[AUTO] Vostok - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vostok-3ka_image_20190207032525.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194207.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] } }, "fastest_turnaround": null }, "launch": { "id": "8050ce4c-2d75-4c11-92e3-132f1db585c6", "url": "https://ll.thespacedevs.com/2.3.0/launches/8050ce4c-2d75-4c11-92e3-132f1db585c6/?format=api", "name": "Vostok | Korabl-Sputnik (4)", "response_mode": "normal", "slug": "vostok-korabl-sputnik-4", "launch_designator": null, "status": { "id": 4, "name": "Launch Failure", "abbrev": "Failure", "description": "Either the launch vehicle did not reach orbit, or the payload(s) failed to separate." }, "last_updated": "2023-06-14T03:48:49Z", "net": "1960-12-22T07:45:19Z", "net_precision": null, "window_end": "1960-12-22T07:45:19Z", "window_start": "1960-12-22T07:45:19Z", "image": { "id": 1862, "name": "[AUTO] Vostok - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vostok_image_20191104130128.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193952.jpeg", "credit": null, "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": 66, "url": "https://ll.thespacedevs.com/2.3.0/agencies/66/?format=api", "name": "Soviet Space Program", "abbrev": "CCCP", "type": { "id": 1, "name": "Government" } }, "rocket": { "id": 3096, "configuration": { "response_mode": "list", "id": 103, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/103/?format=api", "name": "Vostok", "families": [ { "response_mode": "list", "id": 122, "name": "R-7" } ], "full_name": "Vostok-K", "variant": "K" } }, "mission": { "id": 1518, "name": "Korabl-Sputnik (4)", "type": "Test Flight", "description": "Maiden flight of Vostok-K, second stage engine failure, spacecraft separated and recovered. Two dogs aboard, both survived.", "image": null, "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO", "celestial_body": { "response_mode": "list", "id": 1, "name": "Earth" } }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 32, "url": "https://ll.thespacedevs.com/2.3.0/pads/32/?format=api", "active": true, "agencies": [], "name": "1/5", "image": null, "description": null, "info_url": null, "wiki_url": "", "map_url": "https://www.google.com/maps?q=45.92,63.342", "latitude": 45.92, "longitude": 63.342, "country": { "id": 44, "name": "Kazakhstan", "alpha_2_code": "KZ", "alpha_3_code": "KAZ", "nationality_name": "Kazakh", "nationality_name_composed": "Kazakhstani" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_32_20200803143513.jpg", "total_launch_count": 487, "orbital_launch_attempt_count": 487, "fastest_turnaround": "PT23H32M33S", "location": { "response_mode": "normal", "id": 15, "url": "https://ll.thespacedevs.com/2.3.0/locations/15/?format=api", "name": "Baikonur Cosmodrome, Republic of Kazakhstan", "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-prod.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_20240402194304.jpeg", "thumbnail_url": "https://thespacedevs-prod.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": 7147, "successful_launches": 6604, "failed_launches": 543, "total_attempted_landings": 1101, "successful_landings": 1058, "failed_landings": 43 }, "active": true, "country": { "id": 44, "name": "Kazakhstan", "alpha_2_code": "KZ", "alpha_3_code": "KAZ", "nationality_name": "Kazakh", "nationality_name_composed": "Kazakhstani" }, "description": "The Baikonur Cosmodrome is a spaceport operated by Russia within Kazakhstan. Located in the Kazakh city of Baikonur, it is the largest operational space launch facility in terms of area. All Russian crewed spaceflights are launched from Baikonur.", "image": { "id": 2198, "name": "Soyuz launch pad at the Baikonur Cosmodrome", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_launch_pa_image_20240918150530.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_launch_pa_image_thumbnail_20240918150530.jpeg", "credit": "NASA/Bill Ingalls", "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": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_15_20200803142517.jpg", "longitude": 63.305, "latitude": 45.965, "timezone_name": "Asia/Qyzylorda", "total_launch_count": 1555, "total_landing_count": 0 } }, "webcast_live": false, "program": [ { "response_mode": "normal", "id": 9, "url": "https://ll.thespacedevs.com/2.3.0/programs/9/?format=api", "name": "Vostok", "image": { "id": 1881, "name": "[AUTO] Vostok - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vostok_program_20210417063956.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194027.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/Vostok_programme", "description": "The Vostok programme was a Soviet human spaceflight project to put the first Soviet citizens into low Earth orbit and return them safely. Competing with the United States Project Mercury, it succeeded in placing the first human into space, Yuri Gagarin, in a single orbit in Vostok 1 on April 12, 1961.", "agencies": [ { "response_mode": "list", "id": 66, "url": "https://ll.thespacedevs.com/2.3.0/agencies/66/?format=api", "name": "Soviet Space Program", "abbrev": "CCCP", "type": { "id": 1, "name": "Government" } } ], "start_date": "1961-04-12T06:07:00Z", "end_date": "1963-06-19T08:20:00Z", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": 93, "location_launch_attempt_count": 20, "pad_launch_attempt_count": 20, "agency_launch_attempt_count": 20, "orbital_launch_attempt_count_year": 39, "location_launch_attempt_count_year": 9, "pad_launch_attempt_count_year": 9, "agency_launch_attempt_count_year": 9 }, "landing": { "id": 1064, "url": "https://ll.thespacedevs.com/2.3.0/landings/1064/?format=api", "attempt": true, "success": true, "description": "The spacecraft re-entered early due to an early cut-off of the third stage.", "downrange_distance": null, "landing_location": { "id": 33, "name": "Siberia", "active": true, "abbrev": "Siberia", "description": "Siberia is located in the northern part of Russia", "location": null, "longitude": null, "latitude": null, "image": { "id": 2244, "name": "Northern Siberia imaged by Terra", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/northern_siberi_image_20240920094732.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/northern_siberi_image_thumbnail_20240920094732.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": [] }, "successful_landings": 2, "attempted_landings": 2, "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-prod.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_20240402194304.jpeg", "thumbnail_url": "https://thespacedevs-prod.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": "P0D", "turn_around_time": null, "response_mode": "normal" } ] }
