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

{
  "id": 260,
  "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/260/?format=api",
  "name": "Maksim Surayev",
  "status": {
    "id": 2,
    "name": "Retired"
  },
  "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": 483,
    "name": "[AUTO] Maksim Surayev - image",
    "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/maksim2520surayev_image_20181201221714.jpg",
    "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185954.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": "P334DT12H9M34S",
  "eva_time": "PT9H22M",
  "age": 54,
  "date_of_birth": "1972-05-24",
  "date_of_death": null,
  "nationality": [
    {
      "id": 5,
      "name": "Russia",
      "alpha_2_code": "RU",
      "alpha_3_code": "RUS",
      "nationality_name": "Russian",
      "nationality_name_composed": "Russo"
    }
  ],
  "bio": "Maksim Viktorovich Surayev (Russian: Максим Викторович Сураев, born May 24, 1972) is a retired Russian cosmonaut and politician.\r\nFrom December 1997 to November 1999, Surayev completed basic space training. In November 1999 he was qualified as a test-cosmonaut. From January 2000 he was in ISS advanced training. From March 2006 until April 2008 Surayev was assigned as a backup ISS Expedition 17 crewmember. From April 2008 until March 2009 he was a member of the ISS Expedition 19 backup crew.",
  "wiki": "https://en.wikipedia.org/wiki/Maksim_Surayev",
  "last_flight": "2014-05-28T19:57:41Z",
  "first_flight": "2009-09-30T07:14:45Z",
  "social_media_links": [],
  "flights_count": 2,
  "landings_count": 2,
  "spacewalks_count": 2,
  "flights": [],
  "landings": [],
  "spacewalks": [
    {
      "response_mode": "list",
      "id": 339,
      "url": "https://lldev.thespacedevs.com/2.3.0/spacewalks/339/?format=api",
      "name": "Expedition 22 EVA",
      "start": "2010-01-14T10:05:00Z",
      "end": "2010-01-14T15:49:00Z",
      "duration": "PT5H44M",
      "location": "International Space Station",
      "crew": [
        {
          "id": 4446,
          "role": {
            "id": 33,
            "role": "EV1",
            "priority": 0
          },
          "astronaut": {
            "id": 171,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/171/?format=api",
            "name": "Oleg Kotov",
            "status": {
              "id": 2,
              "name": "Retired"
            },
            "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": 819,
              "name": "[AUTO] Oleg Kotov - image",
              "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/oleg2520kotov_image_20181129233807.jpg",
              "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190847.jpeg",
              "credit": null,
              "license": {
                "id": 1,
                "name": "Unknown",
                "priority": 9,
                "link": null
              },
              "single_use": true,
              "variants": []
            },
            "response_mode": "list",
            "type": {
              "id": 2,
              "name": "Government"
            },
            "in_space": false,
            "time_in_space": "P526DT5H3M1S",
            "eva_time": "P1DT12H51M",
            "age": 61,
            "date_of_birth": "1965-10-27",
            "date_of_death": null,
            "nationality": [
              {
                "id": 5,
                "name": "Russia",
                "alpha_2_code": "RU",
                "alpha_3_code": "RUS",
                "nationality_name": "Russian",
                "nationality_name_composed": "Russo"
              }
            ],
            "bio": "Oleg Valeriyevich Kotov (Russian: Олег Валериевич Котов) was born on October 27, 1965, in Simferopol, Crimean oblast in the Ukrainian SSR. After a career as a physician assigned to the Soviet space program, he joined the Russian cosmonaut corps. He has flown two long duration spaceflights on the International Space Station logging just short of a year in space. Most recently, Kotov flew on the Soyuz TMA-10M/Expedition 37/Expedition 38 long duration spaceflight, from September 2013 until March 2014.",
            "wiki": "https://en.wikipedia.org/wiki/Oleg_Kotov",
            "last_flight": "2013-09-25T20:58:50Z",
            "first_flight": "2007-04-07T17:31:09Z",
            "social_media_links": []
          }
        },
        {
          "id": 4447,
          "role": {
            "id": 34,
            "role": "EV2",
            "priority": 1
          },
          "astronaut": {
            "id": 260,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/260/?format=api",
            "name": "Maksim Surayev",
            "status": {
              "id": 2,
              "name": "Retired"
            },
            "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": 483,
              "name": "[AUTO] Maksim Surayev - image",
              "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/maksim2520surayev_image_20181201221714.jpg",
              "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185954.jpeg",
              "credit": null,
              "license": {
                "id": 1,
                "name": "Unknown",
                "priority": 9,
                "link": null
              },
              "single_use": true,
              "variants": []
            },
            "response_mode": "list",
            "type": {
              "id": 2,
              "name": "Government"
            },
            "in_space": false,
            "time_in_space": "P334DT12H9M34S",
            "eva_time": "PT9H22M",
            "age": 54,
            "date_of_birth": "1972-05-24",
            "date_of_death": null,
            "nationality": [
              {
                "id": 5,
                "name": "Russia",
                "alpha_2_code": "RU",
                "alpha_3_code": "RUS",
                "nationality_name": "Russian",
                "nationality_name_composed": "Russo"
              }
            ],
            "bio": "Maksim Viktorovich Surayev (Russian: Максим Викторович Сураев, born May 24, 1972) is a retired Russian cosmonaut and politician.\r\nFrom December 1997 to November 1999, Surayev completed basic space training. In November 1999 he was qualified as a test-cosmonaut. From January 2000 he was in ISS advanced training. From March 2006 until April 2008 Surayev was assigned as a backup ISS Expedition 17 crewmember. From April 2008 until March 2009 he was a member of the ISS Expedition 19 backup crew.",
            "wiki": "https://en.wikipedia.org/wiki/Maksim_Surayev",
            "last_flight": "2014-05-28T19:57:41Z",
            "first_flight": "2009-09-30T07:14:45Z",
            "social_media_links": []
          }
        }
      ]
    },
    {
      "response_mode": "list",
      "id": 371,
      "url": "https://lldev.thespacedevs.com/2.3.0/spacewalks/371/?format=api",
      "name": "Expedition 41 EVA 3",
      "start": "2014-10-22T13:28:00Z",
      "end": "2014-10-22T17:06:00Z",
      "duration": "PT3H38M",
      "location": "International Space Station",
      "crew": [
        {
          "id": 4510,
          "role": {
            "id": 33,
            "role": "EV1",
            "priority": 0
          },
          "astronaut": {
            "id": 260,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/260/?format=api",
            "name": "Maksim Surayev",
            "status": {
              "id": 2,
              "name": "Retired"
            },
            "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": 483,
              "name": "[AUTO] Maksim Surayev - image",
              "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/maksim2520surayev_image_20181201221714.jpg",
              "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185954.jpeg",
              "credit": null,
              "license": {
                "id": 1,
                "name": "Unknown",
                "priority": 9,
                "link": null
              },
              "single_use": true,
              "variants": []
            },
            "response_mode": "list",
            "type": {
              "id": 2,
              "name": "Government"
            },
            "in_space": false,
            "time_in_space": "P334DT12H9M34S",
            "eva_time": "PT9H22M",
            "age": 54,
            "date_of_birth": "1972-05-24",
            "date_of_death": null,
            "nationality": [
              {
                "id": 5,
                "name": "Russia",
                "alpha_2_code": "RU",
                "alpha_3_code": "RUS",
                "nationality_name": "Russian",
                "nationality_name_composed": "Russo"
              }
            ],
            "bio": "Maksim Viktorovich Surayev (Russian: Максим Викторович Сураев, born May 24, 1972) is a retired Russian cosmonaut and politician.\r\nFrom December 1997 to November 1999, Surayev completed basic space training. In November 1999 he was qualified as a test-cosmonaut. From January 2000 he was in ISS advanced training. From March 2006 until April 2008 Surayev was assigned as a backup ISS Expedition 17 crewmember. From April 2008 until March 2009 he was a member of the ISS Expedition 19 backup crew.",
            "wiki": "https://en.wikipedia.org/wiki/Maksim_Surayev",
            "last_flight": "2014-05-28T19:57:41Z",
            "first_flight": "2009-09-30T07:14:45Z",
            "social_media_links": []
          }
        },
        {
          "id": 4511,
          "role": {
            "id": 34,
            "role": "EV2",
            "priority": 1
          },
          "astronaut": {
            "id": 239,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/239/?format=api",
            "name": "Aleksandr Samokutyayev",
            "status": {
              "id": 2,
              "name": "Retired"
            },
            "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": 470,
              "name": "[AUTO] Aleksandr Samokutyayev - image",
              "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/aleksandr2520samokutyayev_image_20181201214845.jpg",
              "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185934.jpeg",
              "credit": null,
              "license": {
                "id": 1,
                "name": "Unknown",
                "priority": 9,
                "link": null
              },
              "single_use": true,
              "variants": []
            },
            "response_mode": "list",
            "type": {
              "id": 2,
              "name": "Government"
            },
            "in_space": false,
            "time_in_space": "P331DT11H22M40S",
            "eva_time": "PT10H1M",
            "age": 56,
            "date_of_birth": "1970-03-13",
            "date_of_death": null,
            "nationality": [
              {
                "id": 5,
                "name": "Russia",
                "alpha_2_code": "RU",
                "alpha_3_code": "RUS",
                "nationality_name": "Russian",
                "nationality_name_composed": "Russo"
              }
            ],
            "bio": "Aleksandr Mikhailovich Samokutyayev (Александр Михайлович Самокутяев – born 13 March 1970 in Penza / Penza Oblast / Russian SFSR) is a former Russian cosmonaut. Samokutyayev served as a Flight Engineer for the International Space Station (ISS) long duration Expedition 27/28 missions. He also served as the Soyuz TMA-21 commander. He most recently served on the Soyuz TMA-14M Expedition 41/42 crew aboard the ISS. He was hired as a cosmonaut in the summer of 2003.",
            "wiki": "https://en.wikipedia.org/wiki/Aleksandr_Samokutyayev",
            "last_flight": "2014-09-25T20:25:00Z",
            "first_flight": "2011-04-04T22:18:20Z",
            "social_media_links": []
          }
        }
      ]
    }
  ]
}