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

{
  "count": 862,
  "next": null,
  "previous": "https://lldev.thespacedevs.com/2.3.0/astronauts/?format=api&limit=10&offset=850&ordering=status",
  "results": [
    {
      "id": 794,
      "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/794/?format=api",
      "name": "Carol Schaller",
      "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": null,
      "response_mode": "normal",
      "type": {
        "id": 3,
        "name": "Private"
      },
      "in_space": false,
      "time_in_space": "PT9M53S",
      "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": "Carol is a retired CPA. In 2017, her doctor told her she would likely go blind. She has since traveled to 25 countries around the world, visited Mount Everest Base Camp, trekked to the Bwindi Impenetrable Forest of Uganda to see mountain gorillas, visited the South Pole, and camped in a tent in the desolate Antarctic plain at -20 degrees. Seeing Earth’s thin layer of atmosphere in the blackness of space will fulfill a lifelong dream.",
      "wiki": null,
      "last_flight": "2024-05-19T14:35:09Z",
      "first_flight": "2024-05-19T14:35:09Z",
      "social_media_links": [],
      "flights_count": 1,
      "landings_count": 1,
      "spacewalks_count": 0
    },
    {
      "id": 791,
      "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/791/?format=api",
      "name": "Mason Angel",
      "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": null,
      "response_mode": "normal",
      "type": {
        "id": 3,
        "name": "Private"
      },
      "in_space": false,
      "time_in_space": "PT9M53S",
      "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": "Mason is the founder of Industrious Ventures, a venture capital fund supporting early-stage companies that enable or progress new industrial revolutions. Mason is an active member in his family’s foundation and will use this mission to inspire children and advance partnerships with nonprofits focused on STEM in early education. He spends his free time skiing or hiking in the Rocky Mountains and can often be found with his dog Leo, named for low Earth orbit.",
      "wiki": null,
      "last_flight": "2024-05-19T14:35:09Z",
      "first_flight": "2024-05-19T14:35:09Z",
      "social_media_links": [
        {
          "id": 213,
          "social_media": {
            "id": 4,
            "name": "LinkedIn",
            "url": "https://www.linkedin.com/",
            "logo": {
              "id": 2321,
              "name": "LinkedIn logo",
              "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/linkedin_logo_image_20250211191111.png",
              "thumbnail_url": "https://thespacedevs-dev.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/mason-a-0538a0195/"
        }
      ],
      "flights_count": 1,
      "landings_count": 1,
      "spacewalks_count": 0
    }
  ]
}