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

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/125/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": 125,
    "url": "https://ll.thespacedevs.com/2.3.0/astronauts/125/?format=api",
    "name": "Jeremy Hansen",
    "status": {
        "id": 1,
        "name": "Active"
    },
    "agency": {
        "response_mode": "list",
        "id": 16,
        "url": "https://ll.thespacedevs.com/2.3.0/agencies/16/?format=api",
        "name": "Canadian Space Agency",
        "abbrev": "CSA",
        "type": {
            "id": 1,
            "name": "Government"
        }
    },
    "image": {
        "id": 700,
        "name": "[AUTO] Jeremy Hansen - image",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/jeremy2520hansen_image_20181129202847.jpg",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190535.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": "P0D",
    "eva_time": "P0D",
    "age": 49,
    "date_of_birth": "1976-01-27",
    "date_of_death": null,
    "nationality": [
        {
            "id": 26,
            "name": "Canada",
            "alpha_2_code": "CA",
            "alpha_3_code": "CAN",
            "nationality_name": "Canadian",
            "nationality_name_composed": "Canado"
        }
    ],
    "bio": "Jeremy Roger Hansen  is a Canadian astronaut with the Canadian Space Agency (CSA). He was selected to join the CSA in the 2009 CSA selection.",
    "wiki": "https://en.wikipedia.org/wiki/Jeremy_Hansen",
    "last_flight": null,
    "first_flight": null,
    "social_media_links": [
        {
            "id": 197,
            "social_media": {
                "id": 1,
                "name": "X",
                "url": "https://x.com",
                "logo": {
                    "id": 2320,
                    "name": "X logo",
                    "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/x_logo_image_20250211191027.jpg",
                    "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/x_logo_image_thumbnail_20250211191027.jpeg",
                    "credit": "X",
                    "license": {
                        "id": 1,
                        "name": "Unknown",
                        "priority": 9,
                        "link": null
                    },
                    "single_use": true,
                    "variants": []
                }
            },
            "url": "https://twitter.com/Astro_Jeremy"
        }
    ],
    "flights_count": 0,
    "landings_count": 0,
    "spacewalks_count": 0,
    "flights": [],
    "landings": [
        {
            "id": 759,
            "url": "https://ll.thespacedevs.com/2.3.0/spacecraft_flights/759/?format=api",
            "destination": "Circumlunar flyby",
            "mission_end": null,
            "spacecraft": {
                "response_mode": "normal",
                "id": 540,
                "url": "https://ll.thespacedevs.com/2.3.0/spacecraft/540/?format=api",
                "name": "Orion 003",
                "serial_number": "003",
                "is_placeholder": false,
                "image": {
                    "id": 1919,
                    "name": "Orion approaching the Moon (Artemis I)",
                    "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/orion_image_20231118102035.jpeg",
                    "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194133.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": "P0D",
                "time_docked": "P0D",
                "flights_count": 0,
                "mission_ends_count": 0,
                "status": {
                    "id": 5,
                    "name": "Under construction"
                },
                "description": "Orion spacecraft used for Artemis 2.",
                "spacecraft_config": {
                    "response_mode": "normal",
                    "id": 4,
                    "url": "https://ll.thespacedevs.com/2.3.0/spacecraft_configurations/4/?format=api",
                    "name": "Orion",
                    "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": true,
                    "image": {
                        "id": 1919,
                        "name": "Orion approaching the Moon (Artemis I)",
                        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/orion_image_20231118102035.jpeg",
                        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194133.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": []
                    }
                },
                "fastest_turnaround": null
            },
            "launch": {
                "id": "41699701-2ef4-4b0c-ac9d-6757820cde87",
                "url": "https://ll.thespacedevs.com/2.3.0/launches/41699701-2ef4-4b0c-ac9d-6757820cde87/?format=api",
                "name": "SLS Block 1 | Artemis II",
                "response_mode": "normal",
                "slug": "sls-block-1-artemis-ii",
                "launch_designator": null,
                "status": {
                    "id": 2,
                    "name": "To Be Determined",
                    "abbrev": "TBD",
                    "description": "Current date is a placeholder or rough estimation based on unreliable or interpreted sources."
                },
                "last_updated": "2025-04-04T07:42:06Z",
                "net": "2026-04-30T00:00:00Z",
                "net_precision": {
                    "id": 7,
                    "name": "Month",
                    "abbrev": "M",
                    "description": "The T-0 is expected in the given month."
                },
                "window_end": "2026-04-30T00:00:00Z",
                "window_start": "2026-04-30T00:00:00Z",
                "image": {
                    "id": 1838,
                    "name": "[AUTO] Space Launch System (SLS) - image",
                    "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/space_launch_sy_image_20220331082429.jpeg",
                    "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193913.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": 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": 187,
                    "configuration": {
                        "response_mode": "list",
                        "id": 143,
                        "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/143/?format=api",
                        "name": "Space Launch System (SLS)",
                        "families": [
                            {
                                "response_mode": "list",
                                "id": 149,
                                "name": "Space Launch System"
                            }
                        ],
                        "full_name": "Space Launch System Block 1",
                        "variant": "Block 1"
                    }
                },
                "mission": {
                    "id": 6343,
                    "name": "Artemis II",
                    "type": "Human Exploration",
                    "description": "Artemis II is the first crewed mission as part of the Artemis program. Artemis II will send a crew of 4 - 3 Americans and 1 Canadian around the moon and return them back to Earth.\r\n\r\nThe mission will test the core systems of NASA's Orion spacecraft including the critical life support system, among other systems which could not be tested during Artemis I due to the lack of crew onboard.",
                    "image": null,
                    "orbit": {
                        "id": 9,
                        "name": "Lunar flyby",
                        "abbrev": "Lunar flyby",
                        "celestial_body": {
                            "response_mode": "list",
                            "id": 1,
                            "name": "Earth"
                        }
                    },
                    "agencies": [],
                    "info_urls": [],
                    "vid_urls": []
                },
                "pad": {
                    "id": 4,
                    "url": "https://ll.thespacedevs.com/2.3.0/pads/4/?format=api",
                    "active": true,
                    "agencies": [
                        {
                            "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": []
                            }
                        }
                    ],
                    "name": "Launch Complex 39B",
                    "image": null,
                    "description": null,
                    "info_url": null,
                    "wiki_url": "https://en.wikipedia.org/wiki/Kennedy_Space_Center_Launch_Complex_39#Launch_Pad_39B",
                    "map_url": "https://www.google.com/maps?q=28.62711233,-80.62101503",
                    "latitude": 28.62711233,
                    "longitude": -80.62101503,
                    "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_4_20200803143518.jpg",
                    "total_launch_count": 58,
                    "orbital_launch_attempt_count": 57,
                    "fastest_turnaround": "P28DT11H55M4S",
                    "location": {
                        "response_mode": "normal",
                        "id": 27,
                        "url": "https://ll.thespacedevs.com/2.3.0/locations/27/?format=api",
                        "name": "Kennedy Space Center, 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": "The John F. Kennedy Space Center, located on Merritt Island, Florida, is one of NASA's ten field centers. Since 1968, KSC has been NASA's primary launch center of American spaceflight, research, and technology. Launch operations for the Apollo, Skylab and Space Shuttle programs were carried out from Kennedy Space Center Launch Complex 39 and managed by KSC. Located on the east coast of Florida, KSC is adjacent to Cape Canaveral Space Force Station (CCSFS).",
                        "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_27_20200803142447.jpg",
                        "longitude": -80.650833,
                        "latitude": 28.524167,
                        "timezone_name": "America/New_York",
                        "total_launch_count": 262,
                        "total_landing_count": 0
                    }
                },
                "webcast_live": false,
                "program": [
                    {
                        "response_mode": "normal",
                        "id": 15,
                        "url": "https://ll.thespacedevs.com/2.3.0/programs/15/?format=api",
                        "name": "Artemis",
                        "image": {
                            "id": 1884,
                            "name": "[AUTO] Artemis - image",
                            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/artemis_program_20220827100930.png",
                            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194033.png",
                            "credit": null,
                            "license": {
                                "id": 1,
                                "name": "Unknown",
                                "priority": 9,
                                "link": null
                            },
                            "single_use": true,
                            "variants": []
                        },
                        "info_url": "https://www.nasa.gov/specials/artemis/",
                        "wiki_url": "https://en.wikipedia.org/wiki/Artemis_program",
                        "description": "The Artemis program is a US government-funded crewed spaceflight program that has the goal of landing \"the first woman and the next man\" on the Moon, specifically at the lunar south pole region by 2024.",
                        "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": "2017-12-11T00:00:00Z",
                        "end_date": null,
                        "mission_patches": [],
                        "type": {
                            "id": 2,
                            "name": "Human Spaceflight"
                        }
                    }
                ],
                "orbital_launch_attempt_count": 7115,
                "location_launch_attempt_count": 266,
                "pad_launch_attempt_count": 59,
                "agency_launch_attempt_count": 142,
                "orbital_launch_attempt_count_year": 7,
                "location_launch_attempt_count_year": 1,
                "pad_launch_attempt_count_year": 1,
                "agency_launch_attempt_count_year": 1
            },
            "landing": {
                "id": 499,
                "url": "https://ll.thespacedevs.com/2.3.0/landings/499/?format=api",
                "attempt": true,
                "success": null,
                "description": "The Orion spacecraft will splash down in the Pacific Ocean.",
                "downrange_distance": null,
                "landing_location": {
                    "id": 18,
                    "name": "Pacific Ocean",
                    "active": true,
                    "abbrev": "PAC",
                    "description": "Pacific Ocean",
                    "location": null,
                    "longitude": null,
                    "latitude": null,
                    "image": {
                        "id": 2242,
                        "name": "Pacific Ocean from the ISS",
                        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/pacific_ocean_f_image_20240920094534.jpg",
                        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/pacific_ocean_f_image_thumbnail_20240920094534.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": 46,
                    "attempted_landings": 48,
                    "failed_landings": 2,
                    "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": null,
            "turn_around_time": null,
            "response_mode": "normal"
        }
    ],
    "spacewalks": []
}