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/386/?format=api
{ "response_mode": "detailed", "id": 386, "url": "https://ll.thespacedevs.com/2.3.0/spacecraft/386/?format=api", "name": "Progress 29", "serial_number": "Progress 29 (No.136)", "is_placeholder": false, "image": { "id": 1920, "name": "[AUTO] Progress 7K-TG - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/progress_7k-tg_image_20231220085840.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194135.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "in_space": false, "time_in_space": "P19DT17H13M43S", "time_docked": "P17DT10H5M10S", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "Progress 29 (Russian: Прогресс 29), was a Progress spacecraft used to resupply the space station Mir.", "spacecraft_config": { "response_mode": "detailed", "id": 8, "url": "https://ll.thespacedevs.com/2.3.0/spacecraft_configurations/8/?format=api", "name": "Progress 7K-TG", "type": { "id": 4, "name": "Cargo Resupply" }, "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": [ { "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": "normal", "id": 1000, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1000/?format=api", "name": "Energia", "abbrev": "OKB-1", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 5, "name": "Russia", "alpha_2_code": "RU", "alpha_3_code": "RUS", "nationality_name": "Russian", "nationality_name_composed": "Russo" } ], "description": null, "administrator": null, "founding_year": 1946, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": null }, "parent": null, "maiden_flight": "1978-01-20", "spacecraft_flown": 183, "total_launch_count": 183, "successful_launches": 180, "failed_launches": 3, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0 } ], "in_use": false, "image": { "id": 1920, "name": "[AUTO] Progress 7K-TG - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/progress_7k-tg_image_20231220085840.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194135.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "capability": "Salyut-7 & Mir Logistics", "history": "Progress 7K-TG , was a Soviet uncrewed spacecraft used to resupply space stations in low Earth orbit. Forty three flew, delivering cargo to Salyut 6, Salyut 7, and Mir. It was the first version of the Progress spacecraft to fly, and spawned later derivatives including the Progress-M which replaced it, and the later Progress-M1.", "details": "Progress is derived from the manned Soyuz spacecraft and is launched on the same vehicle, a Soyuz rocket.\r\nThe purpose of Progress is to deliver supplies needed to sustain human presence in orbit. Currently it is used as a re-supply spacecraft for the ISS.", "maiden_flight": "1978-01-20", "height": 7.23, "diameter": 2.72, "human_rated": false, "crew_capacity": null, "payload_capacity": 1700, "payload_return_capacity": null, "flight_life": "33 to 75 days", "wiki_link": "https://en.wikipedia.org/wiki/Progress_(spacecraft)", "info_link": "https://www.nasa.gov/mission_pages/station/structure/elements/progress.html", "spacecraft_flown": 44, "total_launch_count": 44, "successful_launches": 44, "failed_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "fastest_turnaround": null }, "fastest_turnaround": null, "flights": [ { "id": 540, "url": "https://ll.thespacedevs.com/2.3.0/spacecraft_flights/540/?format=api", "destination": "Mir", "mission_end": "1987-05-11T08:28:00Z", "spacecraft": { "response_mode": "normal", "id": 386, "url": "https://ll.thespacedevs.com/2.3.0/spacecraft/386/?format=api", "name": "Progress 29", "serial_number": "Progress 29 (No.136)", "is_placeholder": false, "image": { "id": 1920, "name": "[AUTO] Progress 7K-TG - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/progress_7k-tg_image_20231220085840.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194135.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "in_space": false, "time_in_space": "P19DT17H13M43S", "time_docked": "P17DT10H5M10S", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "Progress 29 (Russian: Прогресс 29), was a Progress spacecraft used to resupply the space station Mir.", "spacecraft_config": { "response_mode": "normal", "id": 8, "url": "https://ll.thespacedevs.com/2.3.0/spacecraft_configurations/8/?format=api", "name": "Progress 7K-TG", "type": { "id": 4, "name": "Cargo Resupply" }, "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": [ { "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://ll.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": false, "image": { "id": 1920, "name": "[AUTO] Progress 7K-TG - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/progress_7k-tg_image_20231220085840.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194135.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] } }, "fastest_turnaround": null }, "launch": { "id": "0041d2ac-62cb-416f-b67a-cd0277f1cfe2", "url": "https://ll.thespacedevs.com/2.3.0/launches/0041d2ac-62cb-416f-b67a-cd0277f1cfe2/?format=api", "name": "Soyuz-U2 | Progress 29", "response_mode": "normal", "slug": "soyuz-u2-progress-29", "launch_designator": "1987-034", "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-06-14T03:48:51Z", "net": "1987-04-21T15:14:17Z", "net_precision": null, "window_end": "1987-04-21T15:14:17Z", "window_start": "1987-04-21T15:14:17Z", "image": { "id": 1836, "name": "[AUTO] Soyuz-U - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz-u_image_20191229074852.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193910.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "infographic": null, "probability": 0, "weather_concerns": null, "failreason": "", "hashtag": "", "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": 2260, "configuration": { "response_mode": "list", "id": 101, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/101/?format=api", "name": "Soyuz-U", "families": [], "full_name": "Soyuz-U2", "variant": "2" } }, "mission": null, "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": 7140, "successful_launches": 6598, "failed_launches": 542, "total_attempted_landings": 1098, "successful_landings": 1055, "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": 16, "url": "https://ll.thespacedevs.com/2.3.0/programs/16/?format=api", "name": "Mir", "image": { "id": 1891, "name": "[AUTO] Mir - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mir_program_20200821092345.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194046.jpeg", "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/Mir", "description": "Mir was a space station that operated in low Earth orbit from 1986 to 2001, operated by the Soviet Union and later by Russia. Mir was the first modular space station and was assembled in orbit from 1986 to 1996.", "agencies": [ { "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" } }, { "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": "1986-02-20T21:28:23Z", "end_date": "2001-03-23T05:59:00Z", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": 3175, "location_launch_attempt_count": 814, "pad_launch_attempt_count": 238, "agency_launch_attempt_count": 2079, "orbital_launch_attempt_count_year": 3175, "location_launch_attempt_count_year": 14, "pad_launch_attempt_count_year": 6, "agency_launch_attempt_count_year": 29 }, "landing": { "id": 522, "url": "https://ll.thespacedevs.com/2.3.0/landings/522/?format=api", "attempt": false, "success": null, "description": "The Progress spacecraft burned up upon entering Earth's atmosphere.", "downrange_distance": null, "landing_location": null, "type": null }, "duration": "P19DT17H13M43S", "turn_around_time": null, "response_mode": "normal" } ] }
