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=170&ordering=time_in_space
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "count": 813,
    "next": "https://lldev.thespacedevs.com/2.3.0/astronauts/?format=api&limit=10&offset=180&ordering=time_in_space",
    "previous": "https://lldev.thespacedevs.com/2.3.0/astronauts/?format=api&limit=10&offset=160&ordering=time_in_space",
    "results": [
        {
            "id": 111,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/111/?format=api",
            "name": "Yuri Gagarin",
            "status": {
                "id": 11,
                "name": "Deceased"
            },
            "agency": {
                "response_mode": "list",
                "id": 63,
                "url": "https://lldev.thespacedevs.com/2.3.0/agencies/63/?format=api",
                "name": "Russian Federal Space Agency (ROSCOSMOS)",
                "abbrev": "RFSA",
                "type": {
                    "id": 1,
                    "name": "Government"
                }
            },
            "image": {
                "id": 944,
                "name": "[AUTO] Yuri Gagarin - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/yuri2520gagarin_image_20200211151614.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305191209.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "response_mode": "normal",
            "type": {
                "id": 2,
                "name": "Government"
            },
            "in_space": false,
            "time_in_space": "PT1H48M",
            "eva_time": "P0D",
            "age": 34,
            "date_of_birth": "1934-03-09",
            "date_of_death": "1968-03-27",
            "nationality": [
                {
                    "id": 5,
                    "name": "Russia",
                    "alpha_2_code": "RU",
                    "alpha_3_code": "RUS",
                    "nationality_name": "Russian",
                    "nationality_name_composed": "Russo"
                }
            ],
            "bio": "Yuri Alekseyevich Gagarin (Russian: Ю́рий Алексе́евич Гага́рин, IPA: [ˈjʉrʲɪj ɐlʲɪˈksʲejɪvʲɪtɕ ɡɐˈɡarʲɪn]; 9 March 1934 – 27 March 1968) was a Soviet pilot and cosmonaut. He became the first human to journey into outer space when his Vostok spacecraft completed one orbit of the Earth on 12 April 1961.",
            "wiki": "https://en.wikipedia.org/wiki/Yuri_Gagarin",
            "last_flight": "1961-04-12T06:07:00Z",
            "first_flight": "1961-04-12T06:07:00Z",
            "social_media_links": [],
            "flights_count": 1,
            "landings_count": 1,
            "spacewalks_count": 0
        },
        {
            "id": 676,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/676/?format=api",
            "name": "David Mackay",
            "status": {
                "id": 1,
                "name": "Active"
            },
            "agency": {
                "response_mode": "list",
                "id": 1024,
                "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1024/?format=api",
                "name": "Virgin Galactic",
                "abbrev": "VG",
                "type": {
                    "id": 5,
                    "name": "Private"
                }
            },
            "image": {
                "id": 748,
                "name": "[AUTO] David Mackay - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/david_mackay_image_20220911034224.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190659.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": "PT1H57M30S",
            "eva_time": "P0D",
            "age": 68,
            "date_of_birth": "1957-01-01",
            "date_of_death": null,
            "nationality": [
                {
                    "id": 10,
                    "name": "United Kingdom",
                    "alpha_2_code": "GB",
                    "alpha_3_code": "GBR",
                    "nationality_name": "British",
                    "nationality_name_composed": "Brito"
                }
            ],
            "bio": "Astronaut David William Donald Mackay AFC  is the British Chief Pilot of Virgin Galactic, and a former RAF test pilot. He is the first native-born Scot to visit space.",
            "wiki": "https://en.wikipedia.org/wiki/David_Mackay_(pilot)",
            "last_flight": "2021-07-11T15:25:30Z",
            "first_flight": "2012-06-29T12:00:00Z",
            "social_media_links": [],
            "flights_count": 19,
            "landings_count": 19,
            "spacewalks_count": 0
        },
        {
            "id": 648,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/648/?format=api",
            "name": "Joseph A. Walker",
            "status": {
                "id": 11,
                "name": "Deceased"
            },
            "agency": {
                "response_mode": "list",
                "id": 44,
                "url": "https://lldev.thespacedevs.com/2.3.0/agencies/44/?format=api",
                "name": "National Aeronautics and Space Administration",
                "abbrev": "NASA",
                "type": {
                    "id": 1,
                    "name": "Government"
                }
            },
            "image": {
                "id": 261,
                "name": "[AUTO] Joseph A. Walker - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/joseph_a._walke_image_20200711033534.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185351.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "response_mode": "normal",
            "type": {
                "id": 2,
                "name": "Government"
            },
            "in_space": false,
            "time_in_space": "PT2H32M32S",
            "eva_time": "P0D",
            "age": 45,
            "date_of_birth": "1921-02-20",
            "date_of_death": "1966-06-08",
            "nationality": [
                {
                    "id": 2,
                    "name": "United States of America",
                    "alpha_2_code": "US",
                    "alpha_3_code": "USA",
                    "nationality_name": "American",
                    "nationality_name_composed": "Americano"
                }
            ],
            "bio": "Joseph Albert Walker was an American World War II pilot, experimental physicist, NASA test pilot, and astronaut. He was one of twelve pilots who flew the North American X-15, an experimental spaceplane jointly operated by the Air Force and NASA.",
            "wiki": "https://en.wikipedia.org/wiki/Joseph_A._Walker",
            "last_flight": "1963-08-22T18:05:57Z",
            "first_flight": "1963-01-17T16:59:00Z",
            "social_media_links": [],
            "flights_count": 3,
            "landings_count": 3,
            "spacewalks_count": 0
        },
        {
            "id": 23,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/23/?format=api",
            "name": "Scott Carpenter",
            "status": {
                "id": 11,
                "name": "Deceased"
            },
            "agency": {
                "response_mode": "list",
                "id": 44,
                "url": "https://lldev.thespacedevs.com/2.3.0/agencies/44/?format=api",
                "name": "National Aeronautics and Space Administration",
                "abbrev": "NASA",
                "type": {
                    "id": 1,
                    "name": "Government"
                }
            },
            "image": {
                "id": 462,
                "name": "[AUTO] Scott Carpenter - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/scott2520carpenter_image_20190426143651.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185921.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "response_mode": "normal",
            "type": {
                "id": 2,
                "name": "Government"
            },
            "in_space": false,
            "time_in_space": "PT4H55M44S",
            "eva_time": "P0D",
            "age": 88,
            "date_of_birth": "1925-05-01",
            "date_of_death": "2013-10-10",
            "nationality": [
                {
                    "id": 2,
                    "name": "United States of America",
                    "alpha_2_code": "US",
                    "alpha_3_code": "USA",
                    "nationality_name": "American",
                    "nationality_name_composed": "Americano"
                }
            ],
            "bio": "Malcolm Scott Carpenter, was an American naval officer and aviator, test pilot, aeronautical engineer, astronaut, and aquanaut. He was one of the original seven astronauts selected for NASA's Project Mercury in April 1959. Carpenter was the second American (after John Glenn) to orbit the Earth and the fourth American in space, following Alan Shepard, Gus Grissom, and Glenn.",
            "wiki": "https://en.wikipedia.org/wiki/Scott_Carpenter",
            "last_flight": "1962-05-24T12:45:16Z",
            "first_flight": "1962-05-24T12:45:16Z",
            "social_media_links": [],
            "flights_count": 1,
            "landings_count": 1,
            "spacewalks_count": 0
        },
        {
            "id": 670,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/670/?format=api",
            "name": "Peter Siebold",
            "status": {
                "id": 1,
                "name": "Active"
            },
            "agency": {
                "response_mode": "list",
                "id": 1024,
                "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1024/?format=api",
                "name": "Virgin Galactic",
                "abbrev": "VG",
                "type": {
                    "id": 5,
                    "name": "Private"
                }
            },
            "image": {
                "id": 387,
                "name": "[AUTO] Peter Siebold - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/peter_siebold_image_20210522144249.png",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185724.png",
                "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": "PT12H",
            "eva_time": "P0D",
            "age": 54,
            "date_of_birth": "1971-01-01",
            "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": "Peter Siebold is a member of the Scaled Composites astronaut team. He is their Director of Flight Operations was one of the test pilots for SpaceShipOne and SpaceShipTwo. On October 31, 2014, Peter Siebold and Michael Alsbury were piloting the SpaceShipTwo VSS Enterprise on flight PF04, when the craft came apart in mid-air and then crashed, killing Alsbury and injuring Siebold.",
            "wiki": "https://en.wikipedia.org/wiki/Peter_Siebold",
            "last_flight": "2014-10-31T12:00:00Z",
            "first_flight": "2010-10-10T12:00:00Z",
            "social_media_links": [],
            "flights_count": 16,
            "landings_count": 16,
            "spacewalks_count": 0
        },
        {
            "id": 673,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/673/?format=api",
            "name": "Clint Nichols",
            "status": {
                "id": 1,
                "name": "Active"
            },
            "agency": {
                "response_mode": "list",
                "id": 1024,
                "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1024/?format=api",
                "name": "Virgin Galactic",
                "abbrev": "VG",
                "type": {
                    "id": 5,
                    "name": "Private"
                }
            },
            "image": {
                "id": 412,
                "name": "[AUTO] Clint Nichols - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/clint_nichols_image_20210522145635.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185803.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": "PT12H",
            "eva_time": "P0D",
            "age": 55,
            "date_of_birth": "1970-01-01",
            "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": "Clint Nichols is an Aerospace Engineer and Test Pilot for Virgin Galactic's commercial spaceflight program.\r\n\r\nBirthdate is unknown.",
            "wiki": null,
            "last_flight": "2013-09-05T12:00:00Z",
            "first_flight": "2010-11-17T00:00:00Z",
            "social_media_links": [],
            "flights_count": 11,
            "landings_count": 11,
            "spacewalks_count": 0
        },
        {
            "id": 290,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/290/?format=api",
            "name": "Yang Liwei",
            "status": {
                "id": 1,
                "name": "Active"
            },
            "agency": {
                "response_mode": "list",
                "id": 17,
                "url": "https://lldev.thespacedevs.com/2.3.0/agencies/17/?format=api",
                "name": "China National Space Administration",
                "abbrev": "CNSA",
                "type": {
                    "id": 1,
                    "name": "Government"
                }
            },
            "image": {
                "id": 610,
                "name": "[AUTO] Yang Liwei - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/yang2520liwei_image_20181201225703.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190313.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "response_mode": "normal",
            "type": {
                "id": 2,
                "name": "Government"
            },
            "in_space": false,
            "time_in_space": "PT21H22M45S",
            "eva_time": "P0D",
            "age": 59,
            "date_of_birth": "1965-06-21",
            "date_of_death": null,
            "nationality": [
                {
                    "id": 6,
                    "name": "China",
                    "alpha_2_code": "CN",
                    "alpha_3_code": "CHN",
                    "nationality_name": "Chinese",
                    "nationality_name_composed": "Sino"
                }
            ],
            "bio": "Yang Liwei is a major general, military pilot, and China National Space Administration astronaut. In October 2003, he became the first person sent into space by the Chinese space program. This mission, Shenzhou 5, made China the third country to independently send humans into space.",
            "wiki": "https://en.wikipedia.org/wiki/Yang_Liwei",
            "last_flight": "2003-10-15T01:00:03Z",
            "first_flight": "2003-10-15T01:00:03Z",
            "social_media_links": [],
            "flights_count": 1,
            "landings_count": 1,
            "spacewalks_count": 0
        },
        {
            "id": 291,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/291/?format=api",
            "name": "Boris Yegorov",
            "status": {
                "id": 11,
                "name": "Deceased"
            },
            "agency": {
                "response_mode": "list",
                "id": 63,
                "url": "https://lldev.thespacedevs.com/2.3.0/agencies/63/?format=api",
                "name": "Russian Federal Space Agency (ROSCOSMOS)",
                "abbrev": "RFSA",
                "type": {
                    "id": 1,
                    "name": "Government"
                }
            },
            "image": {
                "id": 786,
                "name": "[AUTO] Boris Yegorov - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/boris2520yegorov_image_20181201225827.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190756.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "response_mode": "normal",
            "type": {
                "id": 2,
                "name": "Government"
            },
            "in_space": false,
            "time_in_space": "P1DT17M3S",
            "eva_time": "P0D",
            "age": 56,
            "date_of_birth": "1937-11-26",
            "date_of_death": "1994-09-12",
            "nationality": [
                {
                    "id": 5,
                    "name": "Russia",
                    "alpha_2_code": "RU",
                    "alpha_3_code": "RUS",
                    "nationality_name": "Russian",
                    "nationality_name_composed": "Russo"
                }
            ],
            "bio": "Boris Borisovich Yegorov was a Soviet physician-cosmonaut who became the first physician to make a space flight. Yegorov was selected as a member of the multi-disciplinary team that flew on Voskhod 1.",
            "wiki": "https://en.wikipedia.org/wiki/Boris_Yegorov",
            "last_flight": "1964-10-12T07:30:01Z",
            "first_flight": "1964-10-12T07:30:01Z",
            "social_media_links": [],
            "flights_count": 1,
            "landings_count": 1,
            "spacewalks_count": 0
        },
        {
            "id": 104,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/104/?format=api",
            "name": "Konstantin Feoktistov",
            "status": {
                "id": 11,
                "name": "Deceased"
            },
            "agency": {
                "response_mode": "list",
                "id": 63,
                "url": "https://lldev.thespacedevs.com/2.3.0/agencies/63/?format=api",
                "name": "Russian Federal Space Agency (ROSCOSMOS)",
                "abbrev": "RFSA",
                "type": {
                    "id": 1,
                    "name": "Government"
                }
            },
            "image": {
                "id": 403,
                "name": "[AUTO] Konstantin Feoktistov - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/konstantin2520feoktistov_image_20181128231150.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185749.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "response_mode": "normal",
            "type": {
                "id": 2,
                "name": "Government"
            },
            "in_space": false,
            "time_in_space": "P1DT17M3S",
            "eva_time": "P0D",
            "age": 83,
            "date_of_birth": "1926-02-07",
            "date_of_death": "2009-11-21",
            "nationality": [
                {
                    "id": 5,
                    "name": "Russia",
                    "alpha_2_code": "RU",
                    "alpha_3_code": "RUS",
                    "nationality_name": "Russian",
                    "nationality_name_composed": "Russo"
                }
            ],
            "bio": "Konstantin Petrovich Feoktistov (Russian: Константин Петрович Феоктистов; 7 February 1926 – 21 November 2009) was a Soviet cosmonaut and an eminent space engineer. Feoktistov also wrote several books on space technology and exploration. The Feoktistov crater on the far side of the Moon is named in his honor.",
            "wiki": "https://en.wikipedia.org/wiki/Konstantin_Feoktistov",
            "last_flight": "1964-10-12T07:30:01Z",
            "first_flight": "1964-10-12T07:30:01Z",
            "social_media_links": [],
            "flights_count": 1,
            "landings_count": 1,
            "spacewalks_count": 0
        },
        {
            "id": 266,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/266/?format=api",
            "name": "Gherman Titov",
            "status": {
                "id": 11,
                "name": "Deceased"
            },
            "agency": {
                "response_mode": "list",
                "id": 63,
                "url": "https://lldev.thespacedevs.com/2.3.0/agencies/63/?format=api",
                "name": "Russian Federal Space Agency (ROSCOSMOS)",
                "abbrev": "RFSA",
                "type": {
                    "id": 1,
                    "name": "Government"
                }
            },
            "image": {
                "id": 537,
                "name": "[AUTO] Gherman Titov - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/gherman2520titov_image_20181201222559.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190117.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "response_mode": "normal",
            "type": {
                "id": 2,
                "name": "Government"
            },
            "in_space": false,
            "time_in_space": "P1DT1H18M",
            "eva_time": "P0D",
            "age": 65,
            "date_of_birth": "1935-09-11",
            "date_of_death": "2000-09-20",
            "nationality": [
                {
                    "id": 5,
                    "name": "Russia",
                    "alpha_2_code": "RU",
                    "alpha_3_code": "RUS",
                    "nationality_name": "Russian",
                    "nationality_name_composed": "Russo"
                }
            ],
            "bio": "Gherman Stepanovich Titov (Russian: Герман Степанович Титов; 11 September 1935 – 20 September 2000) was a Soviet cosmonaut who, on 6 August 1961, became the second human to orbit the Earth, aboard Vostok 2, preceded by Yuri Gagarin on Vostok 1. He was the fourth person in space, counting suborbital voyages of US astronauts Alan Shepard and Gus Grissom.",
            "wiki": "https://en.wikipedia.org/wiki/Gherman_Titov",
            "last_flight": "1961-08-06T06:00:00Z",
            "first_flight": "1961-08-06T06:00:00Z",
            "social_media_links": [],
            "flights_count": 1,
            "landings_count": 1,
            "spacewalks_count": 0
        }
    ]
}