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

{
    "count": 165,
    "next": "https://lldev.thespacedevs.com/2.3.0/launchers/?format=api&limit=10&offset=160&ordering=-flights",
    "previous": "https://lldev.thespacedevs.com/2.3.0/launchers/?format=api&limit=10&offset=140&ordering=-flights",
    "results": [
        {
            "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
        },
        {
            "response_mode": "normal",
            "id": 198,
            "url": "https://lldev.thespacedevs.com/2.3.0/launchers/198/?format=api",
            "flight_proven": false,
            "serial_number": "Booster 16",
            "is_placeholder": false,
            "status": {
                "id": 3,
                "name": "active"
            },
            "image": {
                "id": 1997,
                "name": "Starship liftoff (IFT-3)",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/starship_liftof_image_20240314160301.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/starship_liftof_image_thumbnail_20240314160301.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": true,
                "variants": []
            },
            "details": "Super Heavy booster to be used for the 10th Starship flight test.",
            "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": 195,
            "url": "https://lldev.thespacedevs.com/2.3.0/launchers/195/?format=api",
            "flight_proven": false,
            "serial_number": "B1091",
            "is_placeholder": false,
            "status": {
                "id": 3,
                "name": "active"
            },
            "image": {
                "id": 1739,
                "name": "[AUTO] Falcon Heavy - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon_heavy_image_20220129192819.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193632.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "details": "Planned Falcon Heavy center core stage that will first be used as a Falcon 9 first stage booster for several launches.",
            "successful_landings": 0,
            "attempted_landings": 0,
            "flights": 0,
            "last_launch_date": null,
            "first_launch_date": null,
            "fastest_turnaround": null
        },
        {
            "response_mode": "normal",
            "id": 81,
            "url": "https://lldev.thespacedevs.com/2.3.0/launchers/81/?format=api",
            "flight_proven": false,
            "serial_number": "SN7",
            "is_placeholder": false,
            "status": {
                "id": 7,
                "name": "destroyed"
            },
            "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": "Intentionally destroyed during a pressurization test.",
            "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": 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": 98,
            "url": "https://lldev.thespacedevs.com/2.3.0/launchers/98/?format=api",
            "flight_proven": false,
            "serial_number": "BN2.1",
            "is_placeholder": false,
            "status": {
                "id": 6,
                "name": "converted"
            },
            "image": {
                "id": 1849,
                "name": "[AUTO] Super Heavy Prototype - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/super_heavy_pro_image_20210401104735.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193931.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "details": "Second Super Heavy prototype. Transformed into a test tank.",
            "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": 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
        }
    ]
}