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=10&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=20&ordering=flights",
    "previous": "https://lldev.thespacedevs.com/2.3.0/launchers/?format=api&limit=10&ordering=flights",
    "results": [
        {
            "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-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": "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
        },
        {
            "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": 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": 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": 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": 135,
            "url": "https://lldev.thespacedevs.com/2.3.0/launchers/135/?format=api",
            "flight_proven": true,
            "serial_number": "33",
            "is_placeholder": false,
            "status": {
                "id": 2,
                "name": "expended"
            },
            "image": {
                "id": 1553,
                "name": "[AUTO] 33 - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/none_image_20230824193823.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193126.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "details": "Booster used during the \"Virginia Is For Launch Lovers\" mission. First to launch from Wallops.",
            "successful_landings": 0,
            "attempted_landings": 0,
            "flights": 1,
            "last_launch_date": "2023-01-24T23:00:00Z",
            "first_launch_date": "2023-01-24T23:00:00Z",
            "fastest_turnaround": null
        },
        {
            "response_mode": "normal",
            "id": 119,
            "url": "https://lldev.thespacedevs.com/2.3.0/launchers/119/?format=api",
            "flight_proven": true,
            "serial_number": "32",
            "is_placeholder": false,
            "status": {
                "id": 1,
                "name": "retired"
            },
            "image": {
                "id": 1552,
                "name": "[AUTO] 32 - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/119_image_20221104200030.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193124.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "details": "32nd Electron launch vehicle flown on 'Catch Me If You Can'.",
            "successful_landings": 0,
            "attempted_landings": 1,
            "flights": 1,
            "last_launch_date": "2022-11-04T17:27:14Z",
            "first_launch_date": "2022-11-04T17:27:14Z",
            "fastest_turnaround": null
        },
        {
            "response_mode": "normal",
            "id": 142,
            "url": "https://lldev.thespacedevs.com/2.3.0/launchers/142/?format=api",
            "flight_proven": true,
            "serial_number": "25",
            "is_placeholder": false,
            "status": {
                "id": 2,
                "name": "expended"
            },
            "image": {
                "id": 1545,
                "name": "[AUTO] 25 - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/none_image_20231125062800.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193112.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "details": "Booster used during the \" Without Mission A Beat\" mission.",
            "successful_landings": 0,
            "attempted_landings": 0,
            "flights": 1,
            "last_launch_date": "2022-04-02T12:41:38Z",
            "first_launch_date": "2022-04-02T12:41:38Z",
            "fastest_turnaround": null
        },
        {
            "response_mode": "normal",
            "id": 136,
            "url": "https://lldev.thespacedevs.com/2.3.0/launchers/136/?format=api",
            "flight_proven": true,
            "serial_number": "31",
            "is_placeholder": false,
            "status": {
                "id": 2,
                "name": "expended"
            },
            "image": {
                "id": 1551,
                "name": "[AUTO] 31 - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/none_image_20230824194534.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193122.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "details": "Booster used during the \"It Argos Up From Here\" mission.",
            "successful_landings": 0,
            "attempted_landings": 0,
            "flights": 1,
            "last_launch_date": "2022-10-07T17:09:21Z",
            "first_launch_date": "2022-10-07T17:09:21Z",
            "fastest_turnaround": null
        },
        {
            "response_mode": "normal",
            "id": 138,
            "url": "https://lldev.thespacedevs.com/2.3.0/launchers/138/?format=api",
            "flight_proven": true,
            "serial_number": "30",
            "is_placeholder": false,
            "status": {
                "id": 2,
                "name": "expended"
            },
            "image": {
                "id": 1550,
                "name": "[AUTO] 30 - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/none_image_20231125055933.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193121.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "details": "Booster used for the \"The Owl Spreads Its Wings\" mission.",
            "successful_landings": 0,
            "attempted_landings": 0,
            "flights": 1,
            "last_launch_date": "2022-09-15T20:38:00Z",
            "first_launch_date": "2022-09-15T20:38:00Z",
            "fastest_turnaround": null
        }
    ]
}