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": 575,
      "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/575/?format=api",
      "name": "Zena Cardman",
      "status": {
        "id": 1,
        "name": "Active"
      },
      "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": 357,
        "name": "[AUTO] Zena Cardman - image",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/zena2520cardman_image_20200110160428.jpeg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185638.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": "P166DT16H57M54S",
      "eva_time": "P0D",
      "age": 39,
      "date_of_birth": "1987-10-26",
      "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": "Zena Maria Cardman is an American marine biologist and a NASA astronaut of the class of 2017.",
      "wiki": "https://en.wikipedia.org/wiki/Zena_Cardman",
      "last_flight": "2025-08-01T15:43:42Z",
      "first_flight": "2025-08-01T15:43:42Z",
      "social_media_links": [
        {
          "id": 75,
          "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/zenanaut"
        },
        {
          "id": 76,
          "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/zenanaut/"
        }
      ],
      "flights_count": 1,
      "landings_count": 1,
      "spacewalks_count": 0
    },
    {
      "id": 540,
      "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/540/?format=api",
      "name": "Eric Boe",
      "status": {
        "id": 1,
        "name": "Active"
      },
      "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": 356,
        "name": "[AUTO] Eric Boe - image",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/eric2520boe_image_20181203165347.jpg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185636.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": "P28DT15H33M57S",
      "eva_time": "P0D",
      "age": 62,
      "date_of_birth": "1964-10-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": "Eric Allen Boe  is a United States Air Force fighter pilot Colonel, test pilot, a Civil Air Patrol member, and a NASA astronaut. He flew as the pilot of Space Shuttle missions STS-126 and STS-133.",
      "wiki": "https://en.wikipedia.org/wiki/Eric_Boe",
      "last_flight": "2011-02-24T21:53:24Z",
      "first_flight": "2008-11-15T00:55:39Z",
      "social_media_links": [
        {
          "id": 100,
          "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_Boe"
        }
      ],
      "flights_count": 2,
      "landings_count": 2,
      "spacewalks_count": 0
    }
  ]
}