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

{
  "id": 3,
  "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/3/?format=api",
  "name": "Tim Peake",
  "status": {
    "id": 2,
    "name": "Retired"
  },
  "agency": {
    "response_mode": "list",
    "id": 27,
    "url": "https://lldev.thespacedevs.com/2.3.0/agencies/27/?format=api",
    "name": "European Space Agency",
    "abbrev": "ESA",
    "type": {
      "id": 2,
      "name": "Multinational"
    }
  },
  "image": {
    "id": 438,
    "name": "[AUTO] Tim Peake - image",
    "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/tim_peake_image_20230120154350.jpg",
    "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185843.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": "P185DT22H11M51S",
  "eva_time": "PT4H43M",
  "age": 54,
  "date_of_birth": "1972-04-07",
  "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": "Major Timothy Nigel Peake CMG is a British Army Air Corps officer, former European Space Agency astronaut and International Space Station (ISS) crew member.  He is the first British ESA astronaut, the second astronaut to bear a flag of the United Kingdom patch, the sixth person born in the United Kingdom to go on board the International Space Station and the seventh UK-born person in space. He began the ESA's intensive astronaut basic training course in September 2009 and graduated on 22 November 2010",
  "wiki": "https://en.wikipedia.org/wiki/Tim_Peake",
  "last_flight": "2015-12-15T11:03:09Z",
  "first_flight": "2015-12-15T11:03:09Z",
  "social_media_links": [
    {
      "id": 188,
      "social_media": {
        "id": 1,
        "name": "X",
        "url": "https://x.com",
        "logo": {
          "id": 2320,
          "name": "X logo",
          "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/x_logo_image_20250211191027.jpg",
          "thumbnail_url": "https://thespacedevs-dev.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_timpeake"
    },
    {
      "id": 189,
      "social_media": {
        "id": 2,
        "name": "Instagram",
        "url": "https://instagram.com",
        "logo": {
          "id": 2322,
          "name": "Instagram logo",
          "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/instagram_logo_image_20250211191139.png",
          "thumbnail_url": "https://thespacedevs-dev.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/astro_timpeake/"
    }
  ],
  "flights_count": 1,
  "landings_count": 1,
  "spacewalks_count": 1,
  "flights": [],
  "landings": [],
  "spacewalks": [
    {
      "response_mode": "list",
      "id": 379,
      "url": "https://lldev.thespacedevs.com/2.3.0/spacewalks/379/?format=api",
      "name": "Expedition 46 EVA 2",
      "start": "2016-01-15T13:48:00Z",
      "end": "2016-01-15T18:31:00Z",
      "duration": "PT4H43M",
      "location": "International Space Station",
      "crew": [
        {
          "id": 4526,
          "role": {
            "id": 33,
            "role": "EV1",
            "priority": 0
          },
          "astronaut": {
            "id": 549,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/549/?format=api",
            "name": "Timothy Kopra",
            "status": {
              "id": 2,
              "name": "Retired"
            },
            "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": 590,
              "name": "[AUTO] Timothy Kopra - image",
              "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/timothy_kopra_image_20220911033908.jpeg",
              "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190242.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": "P244DT1H1M41S",
            "eva_time": "PT12H31M",
            "age": 63,
            "date_of_birth": "1963-04-09",
            "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": "Timothy Lennart \"Tim\" Kopra is an engineer, a Colonel in the United States Army and a retired NASA astronaut. He served aboard the International Space Station as a flight engineer for Expedition 20, returning to Earth aboard Space Shuttle Discovery on the STS-128 mission on September 11, 2009. He returned to the ISS for the second time in December 2015, as part of Expedition 46 and as the Commander of 47.",
            "wiki": "https://en.wikipedia.org/wiki/Timothy_Kopra",
            "last_flight": "2015-12-15T11:03:09Z",
            "first_flight": "2009-07-15T22:03:10Z",
            "social_media_links": []
          }
        },
        {
          "id": 4527,
          "role": {
            "id": 34,
            "role": "EV2",
            "priority": 1
          },
          "astronaut": {
            "id": 3,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/3/?format=api",
            "name": "Tim Peake",
            "status": {
              "id": 2,
              "name": "Retired"
            },
            "agency": {
              "response_mode": "list",
              "id": 27,
              "url": "https://lldev.thespacedevs.com/2.3.0/agencies/27/?format=api",
              "name": "European Space Agency",
              "abbrev": "ESA",
              "type": {
                "id": 2,
                "name": "Multinational"
              }
            },
            "image": {
              "id": 438,
              "name": "[AUTO] Tim Peake - image",
              "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/tim_peake_image_20230120154350.jpg",
              "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185843.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": "P185DT22H11M51S",
            "eva_time": "PT4H43M",
            "age": 54,
            "date_of_birth": "1972-04-07",
            "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": "Major Timothy Nigel Peake CMG is a British Army Air Corps officer, former European Space Agency astronaut and International Space Station (ISS) crew member.  He is the first British ESA astronaut, the second astronaut to bear a flag of the United Kingdom patch, the sixth person born in the United Kingdom to go on board the International Space Station and the seventh UK-born person in space. He began the ESA's intensive astronaut basic training course in September 2009 and graduated on 22 November 2010",
            "wiki": "https://en.wikipedia.org/wiki/Tim_Peake",
            "last_flight": "2015-12-15T11:03:09Z",
            "first_flight": "2015-12-15T11:03:09Z",
            "social_media_links": [
              {
                "id": 188,
                "social_media": {
                  "id": 1,
                  "name": "X",
                  "url": "https://x.com",
                  "logo": {
                    "id": 2320,
                    "name": "X logo",
                    "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/x_logo_image_20250211191027.jpg",
                    "thumbnail_url": "https://thespacedevs-dev.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_timpeake"
              },
              {
                "id": 189,
                "social_media": {
                  "id": 2,
                  "name": "Instagram",
                  "url": "https://instagram.com",
                  "logo": {
                    "id": 2322,
                    "name": "Instagram logo",
                    "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/instagram_logo_image_20250211191139.png",
                    "thumbnail_url": "https://thespacedevs-dev.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/astro_timpeake/"
              }
            ]
          }
        }
      ]
    }
  ]
}