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/2/?format=api
{ "response_mode": "detailed", "id": 2, "url": "https://ll.thespacedevs.com/2.3.0/spacecraft/2/?format=api", "name": "Mercury No.7", "serial_number": "7", "is_placeholder": false, "image": { "id": 1917, "name": "[AUTO] Mercury - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mercury_image_20190207032519.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194131.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "in_space": false, "time_in_space": "PT15M22S", "time_docked": "P0D", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "Mercury No.7 is the Mercury capsule used for the Mercury-Redstone 3 - callsign \"Freedom 7\" - mission launched on May 5, 1961 and piloted by astronaut Alan Shepard.", "spacecraft_config": { "response_mode": "detailed", "id": 11, "url": "https://ll.thespacedevs.com/2.3.0/spacecraft_configurations/11/?format=api", "name": "Mercury", "type": { "id": 2, "name": "Capsule" }, "agency": { "response_mode": "normal", "id": 44, "url": "https://ll.thespacedevs.com/2.3.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "abbrev": "NASA", "type": { "id": 1, "name": "Government" }, "featured": true, "country": [ { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" } ], "description": "The National Aeronautics and Space Administration is an independent agency of the executive branch of the United States federal government responsible for the civilian space program, as well as aeronautics and aerospace research. NASA have many launch facilities but most are inactive. The most commonly used pad will be LC-39B at Kennedy Space Center in Florida.", "administrator": "Acting Administrator: James Free", "founding_year": 1958, "launchers": "Space Shuttle | SLS", "spacecraft": "Orion", "parent": null, "image": { "id": 19, "name": "[AUTO] National Aeronautics and Space Administration - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_image_20190207032448.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184631.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 161, "name": "[AUTO] National Aeronautics and Space Administration - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_logo_20190207032448.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185043.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 76, "name": "[AUTO] National Aeronautics and Space Administration - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_nation_20230803040809.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184823.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] } }, "family": [], "in_use": false, "image": { "id": 1917, "name": "[AUTO] Mercury - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mercury_image_20190207032519.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194131.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "capability": "Human transportation to upper Earth atmosphere and low Earth orbit.", "history": "The Mercury spacecraft was the manned capsule used for suborbital and orbital launches during the Project Mercury, the first human spaceflight program of the United States, from 1958 through 1963.", "details": "The Mercury spacecraft's principal designer was Maxime Faget, who started research for manned spaceflight during the time of the NACA. With 100 cubic feet (2.8 m3) of habitable volume, the capsule was just large enough for a single crew member. Inside were 120 controls: 55 electrical switches, 30 fuses and 35 mechanical levers. The heaviest spacecraft, Mercury-Atlas 9, weighed 3,000 pounds (1,400 kg) fully loaded. Its outer skin was made of René 41, a nickel alloy able to withstand high temperatures.", "maiden_flight": "1961-05-05", "height": 3.3, "diameter": 1.8, "human_rated": true, "crew_capacity": 1, "payload_capacity": null, "payload_return_capacity": null, "flight_life": "Between 15 minutes and 3 days.", "wiki_link": "https://en.wikipedia.org/wiki/Project_Mercury#Spacecraft", "info_link": "", "spacecraft_flown": 14, "total_launch_count": 17, "successful_launches": 12, "failed_launches": 5, "attempted_landings": 15, "successful_landings": 14, "failed_landings": 1, "fastest_turnaround": "P28DT2H15M" }, "fastest_turnaround": null, "flights": [ { "id": 200, "url": "https://ll.thespacedevs.com/2.3.0/spacecraft_flights/200/?format=api", "destination": "Suborbital", "mission_end": "1961-05-05T14:49:35Z", "spacecraft": { "response_mode": "normal", "id": 2, "url": "https://ll.thespacedevs.com/2.3.0/spacecraft/2/?format=api", "name": "Mercury No.7", "serial_number": "7", "is_placeholder": false, "image": { "id": 1917, "name": "[AUTO] Mercury - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mercury_image_20190207032519.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194131.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "in_space": false, "time_in_space": "PT15M22S", "time_docked": "P0D", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "Mercury No.7 is the Mercury capsule used for the Mercury-Redstone 3 - callsign \"Freedom 7\" - mission launched on May 5, 1961 and piloted by astronaut Alan Shepard.", "spacecraft_config": { "response_mode": "normal", "id": 11, "url": "https://ll.thespacedevs.com/2.3.0/spacecraft_configurations/11/?format=api", "name": "Mercury", "type": { "id": 2, "name": "Capsule" }, "agency": { "response_mode": "list", "id": 44, "url": "https://ll.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": 1917, "name": "[AUTO] Mercury - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mercury_image_20190207032519.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194131.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] } }, "fastest_turnaround": null }, "launch": { "id": "9fe0c6ce-7858-4915-b4e3-7c93f8e56177", "url": "https://ll.thespacedevs.com/2.3.0/launches/9fe0c6ce-7858-4915-b4e3-7c93f8e56177/?format=api", "name": "Redstone MRLV | Mercury-Redstone 3", "response_mode": "normal", "slug": "redstone-mrlv-mercury-redstone-3", "launch_designator": null, "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2023-07-08T08:58:07Z", "net": "1961-05-05T14:34:13Z", "net_precision": null, "window_end": "1961-05-05T14:34:13Z", "window_start": "1961-05-05T14:34:13Z", "image": { "id": 1814, "name": "[AUTO] Redstone - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/redstone_image_20190207032627.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193835.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "infographic": null, "probability": -1, "weather_concerns": null, "failreason": "", "hashtag": null, "launch_service_provider": { "response_mode": "list", "id": 44, "url": "https://ll.thespacedevs.com/2.3.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "abbrev": "NASA", "type": { "id": 1, "name": "Government" } }, "rocket": { "id": 2174, "configuration": { "response_mode": "list", "id": 107, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/107/?format=api", "name": "Redstone", "families": [ { "response_mode": "list", "id": 91, "name": "Redstone" } ], "full_name": "Redstone MRLV", "variant": "MRLV" } }, "mission": { "id": 940, "name": "Mercury-Redstone 3", "type": "Human Exploration", "description": "Mercury-Redstone 3, or Freedom 7, was the first United States human spaceflight, on May 5, 1961, piloted by astronaut Alan Shepard. It was the first manned flight of Project Mercury, the objective of which was to put an astronaut into orbit around the Earth and return him safely. Shepard's mission was a 15-minute suborbital flight with the primary objective of demonstrating his ability to withstand the high g-forces of launch and atmospheric re-entry.", "image": null, "orbit": { "id": 15, "name": "Suborbital", "abbrev": "Sub", "celestial_body": { "response_mode": "list", "id": 1, "name": "Earth" } }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 123, "url": "https://ll.thespacedevs.com/2.3.0/pads/123/?format=api", "active": true, "agencies": [ { "response_mode": "normal", "id": 161, "url": "https://ll.thespacedevs.com/2.3.0/agencies/161/?format=api", "name": "United States Air Force", "abbrev": "USAF", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" } ], "description": "The United States Air Force (USAF) is the air service branch of the United States Armed Forces, and is one of the eight uniformed services of the United States. Originally created on 1 August 1907, as a part of the United States Army Signal Corps, the USAF was established as a separate branch of the United States Armed Forces in 1947 with the enactment of the National Security Act of 1947.", "administrator": "Commander-in-Chief: President of the US", "founding_year": 1947, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": { "id": 193, "name": "[AUTO] United States Air Force - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520states2520air2520force_logo_20230804084626.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185152.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 99, "name": "[AUTO] United States Air Force - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520states2520air2520force_nation_20230804085132.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184855.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] } } ], "name": "Launch Complex 5", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Launch_Complex_5", "map_url": "https://www.google.com/maps?q=28.43942,-80.573301", "latitude": 28.43942, "longitude": -80.573301, "country": { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_123_20200803143235.jpg", "total_launch_count": 13, "orbital_launch_attempt_count": 7, "fastest_turnaround": "P28DT2H15M", "location": { "response_mode": "normal", "id": 12, "url": "https://ll.thespacedevs.com/2.3.0/locations/12/?format=api", "name": "Cape Canaveral SFS, FL, USA", "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": 7140, "successful_launches": 6598, "failed_launches": 542, "total_attempted_landings": 1098, "successful_landings": 1055, "failed_landings": 43 }, "active": true, "country": { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" }, "description": "Cape Canaveral Space Force Station (CCSFS) is an installation of the United States Space Force's Space Launch Delta 45, located on Cape Canaveral in Brevard County, Florida.", "image": { "id": 2200, "name": "Cape Canaveral & KSC seen from orbit (STS-43)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cape_canaveral__image_20240918151615.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cape_canaveral__image_thumbnail_20240918151616.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": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg", "longitude": -80.577778, "latitude": 28.488889, "timezone_name": "America/New_York", "total_launch_count": 1018, "total_landing_count": 64 } }, "webcast_live": false, "program": [ { "response_mode": "normal", "id": 2, "url": "https://ll.thespacedevs.com/2.3.0/programs/2/?format=api", "name": "Mercury", "image": { "id": 1880, "name": "[AUTO] Mercury - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/project2520mer_program_20200820194755.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194025.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "info_url": "https://www.nasa.gov/mission_pages/mercury/missions/program-toc.html", "wiki_url": "https://en.wikipedia.org/wiki/Project_Mercury", "description": "Project Mercury was the first human spaceflight program of the United States, running from 1958 through 1963.", "agencies": [ { "response_mode": "list", "id": 44, "url": "https://ll.thespacedevs.com/2.3.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "abbrev": "NASA", "type": { "id": 1, "name": "Government" } } ], "start_date": "1958-10-07T00:00:00Z", "end_date": "1963-05-16T23:24:02Z", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": null, "location_launch_attempt_count": 59, "pad_launch_attempt_count": 12, "agency_launch_attempt_count": 28, "orbital_launch_attempt_count_year": 0, "location_launch_attempt_count_year": 9, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 9 }, "landing": { "id": 493, "url": "https://ll.thespacedevs.com/2.3.0/landings/493/?format=api", "attempt": true, "success": true, "description": "The Mercury spacecraft safely splashed down in the Atlantic Ocean.", "downrange_distance": null, "landing_location": { "id": 6, "name": "Atlantic Ocean", "active": true, "abbrev": "ATL", "description": "Atlantic Ocean", "location": null, "longitude": null, "latitude": null, "image": { "id": 2230, "name": "Sun glint on the Atlantic Ocean", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/sun_glint_on_th_image_20240920085841.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/sun_glint_on_th_image_thumbnail_20240920085841.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": 37, "attempted_landings": 41, "failed_landings": 4, "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": "PT15M22S", "turn_around_time": null, "response_mode": "normal" } ] }
