Astronaut Instance
Modes
Levels of detail in the response - list, normal, detailed
Example - /astronauts/?mode=list
Filters
Parameters - age, age__gt, age__gte, age__lt, age__lte, agency_ids, date_of_birth, date_of_birth__gt, date_of_birth__gte, date_of_birth__lt, date_of_birth__lte, date_of_death, date_of_death__gt, date_of_death__gte, date_of_death__lt, date_of_death__lte, first_flight, first_flight__gt, first_flight__gte, first_flight__lt, first_flight__lte, flights_count, flights_count__gt, flights_count__gte, flights_count__lt, flights_count__lte, has_flown, in_space, is_human, landings_count, landings_count__gt, landings_count__gte, landings_count__lt, landings_count__lte, last_flight, last_flight__gt, last_flight__gte, last_flight__lt, last_flight__lte, nationality, status_ids, type__id
Example - /astronauts/?has_flown=true
Search
Fields searched - agency__abbrev, agency__name, name, nationality__nationality_name
Example - /astronauts/?search=Pesquet
Ordering
Fields - age, date_of_birth, eva_time, flights_count, id, landings_count, last_flight, name, spacewalks_count, status, time_in_space
Example - /astronauts/?ordering=-time_in_space
Number of results
Use limit to control the number of objects in the response (max 100)
Example - /astronauts/?limit=2
Format
Switch to JSON output - /astronauts/?format=json
Help
Find all the FAQs and support links on the documentation homepage - ll.thespacedevs.com/docs
GET /2.3.0/astronauts/695/?format=api
{ "id": 695, "url": "https://ll.thespacedevs.com/2.3.0/astronauts/695/?format=api", "name": "John B. McKay", "status": { "id": 11, "name": "Deceased" }, "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" } }, "image": { "id": 417, "name": "[AUTO] John B. McKay - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/john_b._mckay_image_20210801073638.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185811.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "response_mode": "detailed", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "PT12M", "eva_time": "P0D", "age": 52, "date_of_birth": "1922-12-08", "date_of_death": "1975-04-27", "nationality": [ { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" } ], "bio": "John Barron McKay was an American naval officer, World War II pilot, aeronautical engineer, test pilot, and astronaut. He flew the X-15 experimental spaceplane to over 50 miles in altitude on Flight 150.", "wiki": "https://en.wikipedia.org/wiki/John_B._McKay", "last_flight": "1965-09-28T18:08:00Z", "first_flight": "1965-09-28T18:08:00Z", "social_media_links": [], "flights_count": 1, "landings_count": 1, "spacewalks_count": 0, "flights": [ { "id": "64a43bcc-f080-4121-91da-90731c46dc82", "url": "https://ll.thespacedevs.com/2.3.0/launches/64a43bcc-f080-4121-91da-90731c46dc82/?format=api", "name": "X-15 | Flight 150", "response_mode": "normal", "slug": "x-15-flight-150", "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-06-14T08:59:15Z", "net": "1965-09-28T18:08:00Z", "net_precision": null, "window_end": "1965-09-28T18:20:00Z", "window_start": "1965-09-28T18:08:00Z", "image": { "id": 1796, "name": "[AUTO] North American X-15 - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/north_american__image_20210813101104.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193805.png", "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": 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" } }, "rocket": { "id": 2987, "configuration": { "response_mode": "list", "id": 209, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/209/?format=api", "name": "North American X-15", "families": [], "full_name": "North American X-15", "variant": "" } }, "mission": { "id": 1412, "name": "Flight 150", "type": "Test Flight", "description": "Flight 150 of the North American X-15 was a test flight conducted by NASA and the US Air Force in 1965. Piloted by John B. McKay it reached an altitude of 90.0 km.", "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": 112, "url": "https://ll.thespacedevs.com/2.3.0/pads/112/?format=api", "active": true, "agencies": [], "name": "Edwards Air Force Base", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Edwards_Air_Force_Base", "map_url": "https://www.google.com/maps?q=34.905556,-117.883611", "latitude": 34.905556, "longitude": -117.883611, "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_112_20200803143214.jpg", "total_launch_count": 13, "orbital_launch_attempt_count": 0, "fastest_turnaround": "P16DT2H39M", "location": { "response_mode": "normal", "id": 144, "url": "https://ll.thespacedevs.com/2.3.0/locations/144/?format=api", "name": "Air launch to Suborbital flight", "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": 17, "name": "Unknown", "alpha_2_code": "??", "alpha_3_code": "???", "nationality_name": "Earthling", "nationality_name_composed": "Earthling" }, "description": "", "image": { "id": 32, "name": "[AUTO] Virgin Galactic - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin_galactic_image_20210522131723.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184711.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_144_20200803142439.jpg", "longitude": null, "latitude": null, "timezone_name": "", "total_launch_count": 86, "total_landing_count": 0 } }, "webcast_live": false, "program": [ { "response_mode": "normal", "id": 20, "url": "https://ll.thespacedevs.com/2.3.0/programs/20/?format=api", "name": "X-15", "image": { "id": 1897, "name": "[AUTO] X-15 - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/x-15_program_20210809102752.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194057.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/North_American_X-15", "description": "Experimental hypersonic rocket-powered aircraft.", "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" } }, { "response_mode": "list", "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" } } ], "start_date": "1959-03-10T00:00:00Z", "end_date": "1968-12-12T00:00:00Z", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": null, "location_launch_attempt_count": 14, "pad_launch_attempt_count": 8, "agency_launch_attempt_count": 283, "orbital_launch_attempt_count_year": 0, "location_launch_attempt_count_year": 3, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 52 } ], "landings": [ { "id": 683, "url": "https://ll.thespacedevs.com/2.3.0/spacecraft_flights/683/?format=api", "destination": "Suborbital", "mission_end": "1965-09-28T18:20:00Z", "spacecraft": { "response_mode": "normal", "id": 444, "url": "https://ll.thespacedevs.com/2.3.0/spacecraft/444/?format=api", "name": "X-15-3", "serial_number": "56-6672", "is_placeholder": false, "image": { "id": 2151, "name": "X-15 #3 on the Lakebed at Edwards Air Force Base", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/x-15_25233_on__image_20240812144229.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/x-15_25233_on__image_thumbnail_20240812144229.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": [] }, "in_space": false, "time_in_space": "PT3H51M32S", "time_docked": "P0D", "flights_count": 11, "mission_ends_count": 11, "status": { "id": 3, "name": "Destroyed" }, "description": "Third X-15 experimental rocket plane. Destroyed during flight 191.", "spacecraft_config": { "response_mode": "normal", "id": 13, "url": "https://ll.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://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": 1918, "name": "[AUTO] North American X-15 - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/north2520american2520x-15_image_20190207032520.jpeg", "thumbnail_url": "https://thespacedevs-prod.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": "P22DT14M5S" }, "launch": { "id": "64a43bcc-f080-4121-91da-90731c46dc82", "url": "https://ll.thespacedevs.com/2.3.0/launches/64a43bcc-f080-4121-91da-90731c46dc82/?format=api", "name": "X-15 | Flight 150", "response_mode": "normal", "slug": "x-15-flight-150", "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-06-14T08:59:15Z", "net": "1965-09-28T18:08:00Z", "net_precision": null, "window_end": "1965-09-28T18:20:00Z", "window_start": "1965-09-28T18:08:00Z", "image": { "id": 1796, "name": "[AUTO] North American X-15 - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/north_american__image_20210813101104.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193805.png", "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": 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" } }, "rocket": { "id": 2987, "configuration": { "response_mode": "list", "id": 209, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/209/?format=api", "name": "North American X-15", "families": [], "full_name": "North American X-15", "variant": "" } }, "mission": { "id": 1412, "name": "Flight 150", "type": "Test Flight", "description": "Flight 150 of the North American X-15 was a test flight conducted by NASA and the US Air Force in 1965. Piloted by John B. McKay it reached an altitude of 90.0 km.", "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": 112, "url": "https://ll.thespacedevs.com/2.3.0/pads/112/?format=api", "active": true, "agencies": [], "name": "Edwards Air Force Base", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Edwards_Air_Force_Base", "map_url": "https://www.google.com/maps?q=34.905556,-117.883611", "latitude": 34.905556, "longitude": -117.883611, "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_112_20200803143214.jpg", "total_launch_count": 13, "orbital_launch_attempt_count": 0, "fastest_turnaround": "P16DT2H39M", "location": { "response_mode": "normal", "id": 144, "url": "https://ll.thespacedevs.com/2.3.0/locations/144/?format=api", "name": "Air launch to Suborbital flight", "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": 17, "name": "Unknown", "alpha_2_code": "??", "alpha_3_code": "???", "nationality_name": "Earthling", "nationality_name_composed": "Earthling" }, "description": "", "image": { "id": 32, "name": "[AUTO] Virgin Galactic - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/virgin_galactic_image_20210522131723.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184711.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_144_20200803142439.jpg", "longitude": null, "latitude": null, "timezone_name": "", "total_launch_count": 86, "total_landing_count": 0 } }, "webcast_live": false, "program": [ { "response_mode": "normal", "id": 20, "url": "https://ll.thespacedevs.com/2.3.0/programs/20/?format=api", "name": "X-15", "image": { "id": 1897, "name": "[AUTO] X-15 - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/x-15_program_20210809102752.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194057.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/North_American_X-15", "description": "Experimental hypersonic rocket-powered aircraft.", "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" } }, { "response_mode": "list", "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" } } ], "start_date": "1959-03-10T00:00:00Z", "end_date": "1968-12-12T00:00:00Z", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": null, "location_launch_attempt_count": 14, "pad_launch_attempt_count": 8, "agency_launch_attempt_count": 283, "orbital_launch_attempt_count_year": 0, "location_launch_attempt_count_year": 3, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 52 }, "landing": { "id": 1136, "url": "https://ll.thespacedevs.com/2.3.0/landings/1136/?format=api", "attempt": true, "success": true, "description": "The X-15 aircraft successfully landed after this flight.", "downrange_distance": null, "landing_location": { "id": 23, "name": "Edwards Air Force Base", "active": true, "abbrev": "KEDW", "description": "Edwards Air Force Base in California.", "location": { "response_mode": "normal", "id": 162, "url": "https://ll.thespacedevs.com/2.3.0/locations/162/?format=api", "name": "Edwards Air Force Base", "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": "Edwards Air Force Base is a United States Air Force installation in California. Edwards is the home of the Air Force Test Center, Air Force Test Pilot School, and NASA's Armstrong Flight Research Center. It is the Air Force Materiel Command center for conducting and supporting research and development of flight, as well as testing and evaluating aerospace systems from concept to combat. It also hosts many test activities conducted by America's commercial aerospace industry.", "image": { "id": 2202, "name": "Edwards Air Force Base from space", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/edwards_air_for_image_20240918153919.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/edwards_air_for_image_thumbnail_20240918153919.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_edwards_air_force_base_20230422085221.jpg", "longitude": -117.883611, "latitude": 34.905556, "timezone_name": "America/Los_Angeles", "total_launch_count": 0, "total_landing_count": 0 }, "longitude": -117.883611, "latitude": 34.905556, "image": { "id": 2233, "name": "Edwards AFB", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/edwards_afb_image_20240920091207.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/edwards_afb_image_thumbnail_20240920091207.jpeg", "credit": "USAF", "license": { "id": 17, "name": "Department of Defense Image Use Policy", "priority": 6, "link": "https://www.dimoc.mil/resources/limitations/" }, "single_use": true, "variants": [] }, "successful_landings": 66, "attempted_landings": 66, "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": 6, "name": "Horizontal Landing", "abbrev": "HL", "description": "Horizontal landing on a runway or flat surface." } }, "duration": "PT12M", "turn_around_time": "P48DT22H34M", "response_mode": "normal" } ], "spacewalks": [] }
