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

{
    "count": 160,
    "next": "https://lldev.thespacedevs.com/2.3.0/launchers/?format=api&limit=10&offset=10&ordering=flights",
    "previous": null,
    "results": [
        {
            "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-prod.nyc3.digitaloceanspaces.com/media/images/78_image_20200917062030.jpg",
                "thumbnail_url": "https://thespacedevs-prod.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": 75,
            "url": "https://lldev.thespacedevs.com/2.3.0/launchers/75/?format=api",
            "flight_proven": false,
            "serial_number": "Mk1",
            "is_placeholder": false,
            "status": {
                "id": 7,
                "name": "destroyed"
            },
            "image": {
                "id": 1243,
                "name": "Starship MK1 at the build site",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/starship_mk1_at_image_20240307091751.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/starship_mk1_at_image_thumbnail_20240307091751.jpeg",
                "credit": "Elon Musk",
                "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": "Starship Mk1 was partially destroyed during max pressure tank testing, when the forward LOX tank ruptured along a weld line of the craft's steel structure, propelling the bulkhead several meters upwards.",
            "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-prod.nyc3.digitaloceanspaces.com/media/images/103_image_20210807065411.jpg",
                "thumbnail_url": "https://thespacedevs-prod.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-prod.nyc3.digitaloceanspaces.com/media/images/77_image_20200917061818.jpg",
                "thumbnail_url": "https://thespacedevs-prod.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": 79,
            "url": "https://lldev.thespacedevs.com/2.3.0/launchers/79/?format=api",
            "flight_proven": false,
            "serial_number": "SN4",
            "is_placeholder": false,
            "status": {
                "id": 7,
                "name": "destroyed"
            },
            "image": {
                "id": 1667,
                "name": "[AUTO] SN4 - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/79_image_20200821075148.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193433.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "details": "On April 26, 2020, SN4 successfully completed a cryogenic pressure test. On May 29, 2020, SN4 exploded after engine testing.",
            "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-prod.nyc3.digitaloceanspaces.com/media/images/82_image_20200916201322.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.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": 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-prod.nyc3.digitaloceanspaces.com/media/images/none_image_20210401104946.jpg",
                "thumbnail_url": "https://thespacedevs-prod.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-prod.nyc3.digitaloceanspaces.com/media/images/99_image_20210615130010.jpg",
                "thumbnail_url": "https://thespacedevs-prod.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": 76,
            "url": "https://lldev.thespacedevs.com/2.3.0/launchers/76/?format=api",
            "flight_proven": false,
            "serial_number": "SN1",
            "is_placeholder": false,
            "status": {
                "id": 7,
                "name": "destroyed"
            },
            "image": {
                "id": 1661,
                "name": "[AUTO] SN1 - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/76_image_20200918010747.png",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193423.png",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "details": "SN1 was destroyed when undergoing pressurization.",
            "successful_landings": 0,
            "attempted_landings": 0,
            "flights": 0,
            "last_launch_date": null,
            "first_launch_date": null,
            "fastest_turnaround": null
        },
        {
            "response_mode": "normal",
            "id": 100,
            "url": "https://lldev.thespacedevs.com/2.3.0/launchers/100/?format=api",
            "flight_proven": false,
            "serial_number": "SN16",
            "is_placeholder": false,
            "status": {
                "id": 5,
                "name": "scrapped"
            },
            "image": {
                "id": 1393,
                "name": "Starship SN10 in flight",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/starship2520sn_image_20210413205503.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.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": "Last suborbital Starship prototype built after SN15, to which it is similar in design. SN16 was later scrapped as SpaceX gathered all data necessary through SN9-15 and shifted focus to the Orbital Flight Test.",
            "successful_landings": 0,
            "attempted_landings": 0,
            "flights": 0,
            "last_launch_date": null,
            "first_launch_date": null,
            "fastest_turnaround": null
        }
    ]
}