Modes

Levels of detail in the response - list, normal, detailed

Example - /landings/?mode=list

Filters

Parameters - attempt, firststage_launch__ids, landing_location__ids, landing_type__ids, launcher__ids, launcher_config__ids, launcher_serial_numbers, spacecraft__ids, spacecraft_config__ids, spacecraft_launch__ids, success

Example - /landings/?spacecraft__ids=39,37

Fields searched - firststage__launcher__launcher_config__name, firststage__launcher__serial_number, firststage__rocket__launch__name, landing_location__abbrev, landing_location__name, spacecraftflight__rocket__launch__name, spacecraftflight__spacecraft__name, spacecraftflight__spacecraft__serial_number, spacecraftflight__spacecraft__spacecraft_config__name

Example - /landings/?search=B1059

Ordering

Fields - downrange_distance, id

Example - /landings/?ordering=downrange_distance

Number of results

Use limit to control the number of objects in the response (max 100)

Example - /landings/?limit=2

Format

Switch to JSON output - /landings/?format=json

Help

Find all the FAQs and support links on the documentation homepage - lldev.thespacedevs.com/docs

GET /2.3.0/landings/1626/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
  "id": 1626,
  "url": "https://lldev.thespacedevs.com/2.3.0/landings/1626/?format=api",
  "attempt": true,
  "success": true,
  "description": "The New Shepard booster NS-4 has landed back on the landing pad.",
  "downrange_distance": 3.2,
  "landing_location": {
    "id": 11,
    "name": "Corn Ranch Landing Pad, West Texas",
    "active": true,
    "abbrev": "CR",
    "description": "New Shepard landing site.",
    "location": {
      "response_mode": "normal",
      "id": 29,
      "url": "https://lldev.thespacedevs.com/2.3.0/locations/29/?format=api",
      "name": "Corn Ranch, Van Horn, TX, USA",
      "active": true,
      "country": {
        "id": 2,
        "name": "United States of America",
        "alpha_2_code": "US",
        "alpha_3_code": "USA",
        "nationality_name": "American",
        "nationality_name_composed": "Americano"
      },
      "description": "Corn Ranch, commonly referred to as Launch Site One (LSO), is a spaceport owned and operated by Blue Origin which is located approximately 30 miles north of the town of Van Horn, Texas, United States.",
      "image": {
        "id": 2098,
        "name": "New Shepard liftoff (NS-25)",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/new_shepard_lif_image_20240621062033.jpeg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/new_shepard_lif_image_thumbnail_20240621062033.jpeg",
        "credit": "Blue Origin",
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": true,
        "variants": []
      },
      "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_29_20200803142436.jpg",
      "longitude": -104.757152,
      "latitude": 31.422927,
      "timezone_name": "America/Chicago",
      "total_launch_count": 38,
      "total_landing_count": 38
    },
    "longitude": -104.762793,
    "latitude": 31.451665,
    "image": {
      "id": 1972,
      "name": "NS landing pad with booster landing on it",
      "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/ns_landing_pad__image_20240310165834.jpg",
      "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/ns_landing_pad__image_thumbnail_20240310165835.jpeg",
      "credit": "Blue Origin",
      "license": {
        "id": 1,
        "name": "Unknown",
        "priority": 9,
        "link": null
      },
      "single_use": true,
      "variants": []
    },
    "successful_landings": 33,
    "attempted_landings": 35,
    "failed_landings": 2,
    "celestial_body": {
      "response_mode": "normal",
      "id": 1,
      "name": "Earth",
      "type": {
        "id": 1,
        "name": "Planet"
      },
      "diameter": 12742000.0,
      "mass": 5.972168e+24,
      "gravity": 9.80655,
      "length_of_day": "1 00:00:00",
      "atmosphere": true,
      "image": {
        "id": 2040,
        "name": "Earth (Apollo 17)",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_20240402194304.jpeg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_thumbnail_20240402194305.jpeg",
        "credit": "NASA",
        "license": {
          "id": 4,
          "name": "NASA Image and Media Guidelines",
          "priority": 0,
          "link": "https://www.nasa.gov/nasa-brand-center/images-and-media/"
        },
        "single_use": true,
        "variants": []
      },
      "description": "Earth is the third planet from the Sun and the only astronomical object known to harbor life.",
      "wiki_url": "https://en.wikipedia.org/wiki/Earth"
    }
  },
  "type": {
    "id": 2,
    "name": "Return to Launch Site",
    "abbrev": "RTLS",
    "description": "A return to launch site usually means that after stage separation the booster flips and does a burn back towards the launch site, landing near where it initially launched from."
  },
  "response_mode": "detailed",
  "firststage": {
    "id": 745,
    "type": "Core",
    "reused": true,
    "launcher_flight_number": 14,
    "launcher": {
      "response_mode": "normal",
      "id": 90,
      "url": "https://lldev.thespacedevs.com/2.3.0/launchers/90/?format=api",
      "flight_proven": true,
      "serial_number": "NS-4",
      "is_placeholder": false,
      "status": {
        "id": 3,
        "name": "active"
      },
      "image": {
        "id": 1659,
        "name": "[AUTO] NS-4 - image",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/90_image_20210412202510.jpeg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193420.jpeg",
        "credit": null,
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": true,
        "variants": []
      },
      "details": "New Shepard vehicle #4 is the fourth flight vehicle of the New Shepard suborbital rocket. It was used for Blue Origin's first crewed launches.",
      "successful_landings": 17,
      "attempted_landings": 17,
      "flights": 17,
      "last_launch_date": "2026-01-22T16:25:35Z",
      "first_launch_date": "2021-01-14T17:19:00Z",
      "fastest_turnaround": "P59DT11M42S"
    },
    "previous_flight_date": "2025-02-25T15:49:11Z",
    "turn_around_time": "P94DT21H50M",
    "previous_flight": null
  },
  "spacecraftflight": null,
  "payloadflight": null
}