GET

Launcher List

Modes

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

Example - /launchers/?mode=list

Filters

Parameters - attempted_landings, attempted_landings__gt, attempted_landings__gte, attempted_landings__lt, attempted_landings__lte, first_launch_date, flight_proven, flights, flights__gt, flights__gte, flights__lt, flights__lte, id, id__contains, is_placeholder, last_launch_date, launcher_config__ids, launcher_config__manufacturer__name, launcher_config__manufacturer__name__contains, serial_number, serial_number__contains, status, successful_landings, successful_landings__gt, successful_landings__gte, successful_landings__lt, successful_landings__lte

Example - /launchers/?is_placeholder=True

Fields searched - serial_number, status__name

Example - /launchers/?search=B1048

Ordering

Fields - attempted_landings, flight_proven, flights, id, successful_landings

Example - /launchers/?ordering=-flights

Number of results

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

Example - /launchers/?limit=2

Format

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

Help

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

GET /2.3.0/launchers/?format=api&offset=30&ordering=flight_proven
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
  "count": 196,
  "next": "https://lldev.thespacedevs.com/2.3.0/launchers/?format=api&limit=10&offset=40&ordering=flight_proven",
  "previous": "https://lldev.thespacedevs.com/2.3.0/launchers/?format=api&limit=10&offset=20&ordering=flight_proven",
  "results": [
    {
      "response_mode": "normal",
      "id": 127,
      "url": "https://lldev.thespacedevs.com/2.3.0/launchers/127/?format=api",
      "flight_proven": false,
      "serial_number": "B1084",
      "is_placeholder": false,
      "status": {
        "id": 2,
        "name": "expended"
      },
      "image": {
        "id": 1644,
        "name": "[AUTO] B1084 - image",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/127_image_20231229222119.jpeg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193356.jpeg",
        "credit": null,
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": true,
        "variants": []
      },
      "details": "Falcon Heavy core booster expended during the USSF-52 mission.",
      "successful_landings": 0,
      "attempted_landings": 0,
      "flights": 1,
      "last_launch_date": "2023-12-29T01:07:00Z",
      "first_launch_date": "2023-12-29T01:07:00Z",
      "fastest_turnaround": null
    },
    {
      "response_mode": "normal",
      "id": 93,
      "url": "https://lldev.thespacedevs.com/2.3.0/launchers/93/?format=api",
      "flight_proven": false,
      "serial_number": "BN1",
      "is_placeholder": false,
      "status": {
        "id": 5,
        "name": "scrapped"
      },
      "image": {
        "id": 1645,
        "name": "[AUTO] BN1 - image",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/none_image_20210401104946.jpg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193358.jpeg",
        "credit": null,
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": true,
        "variants": []
      },
      "details": "BN1 was the first Super Heavy prototype built by SpaceX in Boca Chica, TX. It was used as a production and ground operations pathfinder.",
      "successful_landings": 0,
      "attempted_landings": 0,
      "flights": 0,
      "last_launch_date": null,
      "first_launch_date": null,
      "fastest_turnaround": null
    },
    {
      "response_mode": "normal",
      "id": 99,
      "url": "https://lldev.thespacedevs.com/2.3.0/launchers/99/?format=api",
      "flight_proven": false,
      "serial_number": "Booster 3",
      "is_placeholder": false,
      "status": {
        "id": 5,
        "name": "scrapped"
      },
      "image": {
        "id": 1647,
        "name": "[AUTO] Booster 3 - image",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/99_image_20210615130010.jpg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193402.jpeg",
        "credit": null,
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": true,
        "variants": []
      },
      "details": "Super Heavy prototype used for ground testing. First Super Heavy to static fire.",
      "successful_landings": 0,
      "attempted_landings": 0,
      "flights": 0,
      "last_launch_date": null,
      "first_launch_date": null,
      "fastest_turnaround": null
    },
    {
      "response_mode": "normal",
      "id": 103,
      "url": "https://lldev.thespacedevs.com/2.3.0/launchers/103/?format=api",
      "flight_proven": false,
      "serial_number": "Booster 4",
      "is_placeholder": false,
      "status": {
        "id": 1,
        "name": "retired"
      },
      "image": {
        "id": 1648,
        "name": "[AUTO] Booster 4 - image",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/103_image_20210807065411.jpg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193403.jpeg",
        "credit": null,
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": true,
        "variants": []
      },
      "details": "First Super Heavy booster to complete a cryogenic proof test at the Orbital Launch Pad, as well as the first full stack cryogenic proof test for a Starship vehicle. Booster 4 is now on display at SpaceX's Rocket Garden in Boca Chica.",
      "successful_landings": 0,
      "attempted_landings": 0,
      "flights": 0,
      "last_launch_date": null,
      "first_launch_date": null,
      "fastest_turnaround": null
    },
    {
      "response_mode": "normal",
      "id": 77,
      "url": "https://lldev.thespacedevs.com/2.3.0/launchers/77/?format=api",
      "flight_proven": false,
      "serial_number": "SN2",
      "is_placeholder": false,
      "status": {
        "id": 1,
        "name": "retired"
      },
      "image": {
        "id": 1665,
        "name": "[AUTO] SN2 - image",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/77_image_20200917061818.jpg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193429.jpeg",
        "credit": null,
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": true,
        "variants": []
      },
      "details": "SN2 successfully went through a pressure and cryo test, but was not used for a static fire or hop.",
      "successful_landings": 0,
      "attempted_landings": 0,
      "flights": 0,
      "last_launch_date": null,
      "first_launch_date": null,
      "fastest_turnaround": null
    },
    {
      "response_mode": "normal",
      "id": 78,
      "url": "https://lldev.thespacedevs.com/2.3.0/launchers/78/?format=api",
      "flight_proven": false,
      "serial_number": "SN3",
      "is_placeholder": false,
      "status": {
        "id": 7,
        "name": "destroyed"
      },
      "image": {
        "id": 1666,
        "name": "[AUTO] SN3 - image",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/78_image_20200917062030.jpg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193431.jpeg",
        "credit": null,
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": true,
        "variants": []
      },
      "details": "SN3's cryo test failed, the result being the LOX (Liquid Oxygen) Tank collapsing due to underpressurisation.",
      "successful_landings": 0,
      "attempted_landings": 0,
      "flights": 0,
      "last_launch_date": null,
      "first_launch_date": null,
      "fastest_turnaround": null
    },
    {
      "response_mode": "normal",
      "id": 82,
      "url": "https://lldev.thespacedevs.com/2.3.0/launchers/82/?format=api",
      "flight_proven": false,
      "serial_number": "SN7.1",
      "is_placeholder": false,
      "status": {
        "id": 7,
        "name": "destroyed"
      },
      "image": {
        "id": 1670,
        "name": "[AUTO] SN7.1 - image",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/82_image_20200916201322.jpeg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193437.jpeg",
        "credit": null,
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": true,
        "variants": []
      },
      "details": "SpaceX Test tank for 304L Stainless Steel. Top bulkhead intentionally burst during pressure testing.",
      "successful_landings": 0,
      "attempted_landings": 0,
      "flights": 0,
      "last_launch_date": null,
      "first_launch_date": null,
      "fastest_turnaround": null
    },
    {
      "response_mode": "normal",
      "id": 106,
      "url": "https://lldev.thespacedevs.com/2.3.0/launchers/106/?format=api",
      "flight_proven": false,
      "serial_number": "Unknown F9",
      "is_placeholder": true,
      "status": {
        "id": 8,
        "name": "N/A"
      },
      "image": {
        "id": 1674,
        "name": "[AUTO] Unknown F9 - image",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/106_image_20230708172214.png",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193443.png",
        "credit": null,
        "license": {
          "id": 1,
          "name": "Unknown",
          "priority": 9,
          "link": null
        },
        "single_use": true,
        "variants": []
      },
      "details": "Booster serial number unknown.",
      "successful_landings": null,
      "attempted_landings": null,
      "flights": null,
      "last_launch_date": null,
      "first_launch_date": null,
      "fastest_turnaround": null
    },
    {
      "response_mode": "normal",
      "id": 147,
      "url": "https://lldev.thespacedevs.com/2.3.0/launchers/147/?format=api",
      "flight_proven": false,
      "serial_number": "B1087",
      "is_placeholder": false,
      "status": {
        "id": 2,
        "name": "expended"
      },
      "image": {
        "id": 2121,
        "name": "B1087 liftoff (GOES-U)",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/b1086_liftoff__image_20240626195956.jpeg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/b1086_liftoff__image_thumbnail_20240626195956.jpeg",
        "credit": "SpaceX",
        "license": {
          "id": 5,
          "name": "CC BY-NC 2.0",
          "priority": 1,
          "link": "https://creativecommons.org/licenses/by-nc/2.0/"
        },
        "single_use": true,
        "variants": []
      },
      "details": "Falcon Heavy core booster expended during the GOES-U mission.",
      "successful_landings": 0,
      "attempted_landings": 0,
      "flights": 1,
      "last_launch_date": "2024-06-25T21:26:00Z",
      "first_launch_date": "2024-06-25T21:26:00Z",
      "fastest_turnaround": null
    },
    {
      "response_mode": "normal",
      "id": 95,
      "url": "https://lldev.thespacedevs.com/2.3.0/launchers/95/?format=api",
      "flight_proven": false,
      "serial_number": "SN7.2",
      "is_placeholder": false,
      "status": {
        "id": 1,
        "name": "retired"
      },
      "image": {
        "id": 1393,
        "name": "Starship SN10 in flight",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/starship2520sn_image_20210413205503.jpeg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192625.jpeg",
        "credit": "SpaceX",
        "license": {
          "id": 5,
          "name": "CC BY-NC 2.0",
          "priority": 1,
          "link": "https://creativecommons.org/licenses/by-nc/2.0/"
        },
        "single_use": false,
        "variants": []
      },
      "details": "SpaceX test tank for 3mm stainless steel sheets. Retired after two pressure tests.",
      "successful_landings": 0,
      "attempted_landings": 0,
      "flights": 0,
      "last_launch_date": null,
      "first_launch_date": null,
      "fastest_turnaround": null
    }
  ]
}