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

{
  "id": 831,
  "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/831/?format=api",
  "name": "Katy Perry",
  "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": "detailed",
  "type": {
    "id": 3,
    "name": "Private"
  },
  "in_space": false,
  "time_in_space": "PT10M21S",
  "eva_time": "P0D",
  "age": 42,
  "date_of_birth": "1984-10-25",
  "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": "Katheryn Elizabeth Hudson, known professionally as Katy Perry, is an American singer, songwriter, and television personality. Perry is one of the best-selling music artists in history, having sold over 143 million units worldwide. She is known for her influence on pop music and her camp style, being dubbed the \"Queen of Camp\" by Vogue and Rolling Stone.",
  "wiki": "https://en.wikipedia.org/wiki/Katy_Perry",
  "last_flight": "2025-04-14T13:30:00Z",
  "first_flight": "2025-04-14T13:30:00Z",
  "social_media_links": [
    {
      "id": 269,
      "social_media": {
        "id": 3,
        "name": "Homepage",
        "url": null,
        "logo": null
      },
      "url": "https://www.katyperry.com/"
    },
    {
      "id": 270,
      "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/katyperry/"
    },
    {
      "id": 271,
      "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://x.com/katyperry"
    },
    {
      "id": 272,
      "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/katy-perry-587921a8/"
    }
  ],
  "flights_count": 1,
  "landings_count": 1,
  "spacewalks_count": 0,
  "flights": [],
  "landings": [],
  "spacewalks": []
}