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 - lldev.thespacedevs.com/docs

GET /2.3.0/astronauts/?format=api&offset=810&ordering=status
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "count": 813,
    "next": null,
    "previous": "https://lldev.thespacedevs.com/2.3.0/astronauts/?format=api&limit=10&offset=800&ordering=status",
    "results": [
        {
            "id": 661,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/661/?format=api",
            "name": "Chris Sembroski",
            "status": {
                "id": 14,
                "name": "Occasional Spaceflight"
            },
            "agency": {
                "response_mode": "list",
                "id": 121,
                "url": "https://lldev.thespacedevs.com/2.3.0/agencies/121/?format=api",
                "name": "SpaceX",
                "abbrev": "SpX",
                "type": {
                    "id": 3,
                    "name": "Commercial"
                }
            },
            "image": {
                "id": 429,
                "name": "[AUTO] Chris Sembroski - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/chris_sembroski_image_20210914154201.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185829.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "response_mode": "normal",
            "type": {
                "id": 3,
                "name": "Private"
            },
            "in_space": false,
            "time_in_space": "P3DT23H4M4S",
            "eva_time": "P0D",
            "age": 45,
            "date_of_birth": "1979-08-28",
            "date_of_death": null,
            "nationality": [
                {
                    "id": 2,
                    "name": "United States of America",
                    "alpha_2_code": "US",
                    "alpha_3_code": "USA",
                    "nationality_name": "American",
                    "nationality_name_composed": "Americano"
                }
            ],
            "bio": "Chris Sembroski is an aerospace worker at Lockheed Martin who used to work on Minuteman missiles in the Air Force.\r\n\r\nBirth date is unknown.",
            "wiki": "https://en.wikipedia.org/wiki/Christopher_Sembroski",
            "last_flight": "2021-09-16T00:02:56Z",
            "first_flight": "2021-09-16T00:02:56Z",
            "social_media_links": [
                {
                    "id": 154,
                    "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/epathctocs"
                }
            ],
            "flights_count": 1,
            "landings_count": 1,
            "spacewalks_count": 0
        },
        {
            "id": 683,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/683/?format=api",
            "name": "Mark Bezos",
            "status": {
                "id": 14,
                "name": "Occasional Spaceflight"
            },
            "agency": {
                "response_mode": "list",
                "id": 141,
                "url": "https://lldev.thespacedevs.com/2.3.0/agencies/141/?format=api",
                "name": "Blue Origin",
                "abbrev": "BO",
                "type": {
                    "id": 3,
                    "name": "Commercial"
                }
            },
            "image": {
                "id": 643,
                "name": "[AUTO] Mark Bezos - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mark_bezos_image_20220911034437.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190407.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "response_mode": "normal",
            "type": {
                "id": 3,
                "name": "Private"
            },
            "in_space": false,
            "time_in_space": "PT10M",
            "eva_time": "P0D",
            "age": 57,
            "date_of_birth": "1968-05-17",
            "date_of_death": null,
            "nationality": [
                {
                    "id": 2,
                    "name": "United States of America",
                    "alpha_2_code": "US",
                    "alpha_3_code": "USA",
                    "nationality_name": "American",
                    "nationality_name_composed": "Americano"
                }
            ],
            "bio": "Mark Bezos is the Founder and General Partner at HighPost Capital and Director of Bezos Family Foundation.  Apart from this, he is also Senior Vice President of Communication and Marketing events at Robin Hood Foundation, a poverty-fighting charity organization. He is popularly known as the brother of Jeff Bezos.",
            "wiki": "https://en.wikipedia.org/wiki/Mark_Bezos",
            "last_flight": "2021-07-20T13:12:00Z",
            "first_flight": "2021-07-20T13:12:00Z",
            "social_media_links": [],
            "flights_count": 1,
            "landings_count": 1,
            "spacewalks_count": 0
        },
        {
            "id": 812,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/812/?format=api",
            "name": "Karsen Kitchen",
            "status": {
                "id": 14,
                "name": "Occasional Spaceflight"
            },
            "agency": {
                "response_mode": "list",
                "id": 141,
                "url": "https://lldev.thespacedevs.com/2.3.0/agencies/141/?format=api",
                "name": "Blue Origin",
                "abbrev": "BO",
                "type": {
                    "id": 3,
                    "name": "Commercial"
                }
            },
            "image": {
                "id": 2191,
                "name": "Karsen Kitchen portrait",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/karsen_kitchen__image_20240828203507.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/karsen_kitchen__image_thumbnail_20240828203507.jpeg",
                "credit": "Blue Origin",
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "response_mode": "normal",
            "type": {
                "id": 3,
                "name": "Private"
            },
            "in_space": false,
            "time_in_space": "PT10M8S",
            "eva_time": "P0D",
            "age": null,
            "date_of_birth": null,
            "date_of_death": null,
            "nationality": [
                {
                    "id": 2,
                    "name": "United States of America",
                    "alpha_2_code": "US",
                    "alpha_3_code": "USA",
                    "nationality_name": "American",
                    "nationality_name_composed": "Americano"
                }
            ],
            "bio": "Student in Communications and Astronomy, founder of Orbitelle, an initiative to encourage women to pursue careers in the space industry. She has researched radio astronomy at the Green Bank Observatory in West Virginia and worked at UNC's Morehead Planetarium.",
            "wiki": null,
            "last_flight": "2024-08-29T13:07:03Z",
            "first_flight": "2024-08-29T13:07:03Z",
            "social_media_links": [
                {
                    "id": 224,
                    "social_media": {
                        "id": 4,
                        "name": "LinkedIn",
                        "url": "https://www.linkedin.com/",
                        "logo": {
                            "id": 2321,
                            "name": "LinkedIn logo",
                            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/linkedin_logo_image_20250211191111.png",
                            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/linkedin_logo_image_thumbnail_20250211191112.png",
                            "credit": "LinkedIn",
                            "license": {
                                "id": 1,
                                "name": "Unknown",
                                "priority": 9,
                                "link": null
                            },
                            "single_use": true,
                            "variants": []
                        }
                    },
                    "url": "https://www.linkedin.com/in/karsen-kitchen-819b61314/"
                },
                {
                    "id": 225,
                    "social_media": {
                        "id": 2,
                        "name": "Instagram",
                        "url": "https://instagram.com",
                        "logo": {
                            "id": 2322,
                            "name": "Instagram logo",
                            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/instagram_logo_image_20250211191139.png",
                            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/instagram_logo_image_thumbnail_20250211191139.png",
                            "credit": "Instagram",
                            "license": {
                                "id": 1,
                                "name": "Unknown",
                                "priority": 9,
                                "link": null
                            },
                            "single_use": true,
                            "variants": []
                        }
                    },
                    "url": "https://www.instagram.com/karsenkitchen/"
                }
            ],
            "flights_count": 1,
            "landings_count": 1,
            "spacewalks_count": 0
        }
    ]
}