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

{
    "count": 184,
    "next": null,
    "previous": "https://lldev.thespacedevs.com/2.3.0/launchers/?format=api&limit=10&offset=170&ordering=-attempted_landings",
    "results": [
        {
            "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": 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-dev.nyc3.digitaloceanspaces.com/media/images/79_image_20200821075148.jpeg",
                "thumbnail_url": "https://thespacedevs-dev.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": 141,
            "url": "https://lldev.thespacedevs.com/2.3.0/launchers/141/?format=api",
            "flight_proven": true,
            "serial_number": "27",
            "is_placeholder": false,
            "status": {
                "id": 2,
                "name": "expended"
            },
            "image": {
                "id": 1547,
                "name": "[AUTO] 27 - image",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/none_image_20231125062131.jpg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193116.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "details": "Booster used during the NASA Capstone mission.\r\n\r\nBooster features the NASA Worm logo and was flown without onboard cameras to save weight.",
            "successful_landings": 0,
            "attempted_landings": 0,
            "flights": 1,
            "last_launch_date": "2022-06-28T09:55:52Z",
            "first_launch_date": "2022-06-28T09:55:52Z",
            "fastest_turnaround": null
        }
    ]
}