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 - ll.thespacedevs.com/docs

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

{
    "count": 160,
    "next": "https://ll.thespacedevs.com/2.3.0/launchers/?format=api&limit=10&offset=130&ordering=-successful_landings",
    "previous": "https://ll.thespacedevs.com/2.3.0/launchers/?format=api&limit=10&offset=110&ordering=-successful_landings",
    "results": [
        {
            "response_mode": "normal",
            "id": 77,
            "url": "https://ll.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": 78,
            "url": "https://ll.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": 79,
            "url": "https://ll.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": 60,
            "url": "https://ll.thespacedevs.com/2.3.0/launchers/60/?format=api",
            "flight_proven": true,
            "serial_number": "NS-1",
            "is_placeholder": false,
            "status": {
                "id": 7,
                "name": "destroyed"
            },
            "image": {
                "id": 1795,
                "name": "[AUTO] New Shepard - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/new2520shepard_image_20190207032624.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193803.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "details": "New Shepard 1 was destroyed on landing during its first flight.",
            "successful_landings": 0,
            "attempted_landings": 1,
            "flights": 1,
            "last_launch_date": "2015-04-29T17:06:00Z",
            "first_launch_date": "2015-04-29T17:06:00Z",
            "fastest_turnaround": null
        },
        {
            "response_mode": "normal",
            "id": 100,
            "url": "https://ll.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://ll.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": 83,
            "url": "https://ll.thespacedevs.com/2.3.0/launchers/83/?format=api",
            "flight_proven": true,
            "serial_number": "SN8",
            "is_placeholder": false,
            "status": {
                "id": 7,
                "name": "destroyed"
            },
            "image": {
                "id": 1671,
                "name": "[AUTO] SN8 - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/83_image_20201211002626.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193439.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "details": "SN8 was destroyed when attempting to land after its first flight due to low header tank pressure during landing burn.",
            "successful_landings": 0,
            "attempted_landings": 1,
            "flights": 1,
            "last_launch_date": "2020-12-09T22:45:25Z",
            "first_launch_date": "2020-12-09T22:45:25Z",
            "fastest_turnaround": null
        },
        {
            "response_mode": "normal",
            "id": 89,
            "url": "https://ll.thespacedevs.com/2.3.0/launchers/89/?format=api",
            "flight_proven": true,
            "serial_number": "SN9",
            "is_placeholder": false,
            "status": {
                "id": 7,
                "name": "destroyed"
            },
            "image": {
                "id": 1672,
                "name": "[AUTO] SN9 - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/89_image_20210128075700.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193440.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "details": "SN9 is the first starship prototype to be fully made of 304L stainless steel. It was destroyed on landing after its first flight.",
            "successful_landings": 0,
            "attempted_landings": 1,
            "flights": 1,
            "last_launch_date": "2021-02-02T20:25:15Z",
            "first_launch_date": "2021-02-02T20:25:15Z",
            "fastest_turnaround": null
        },
        {
            "response_mode": "normal",
            "id": 131,
            "url": "https://ll.thespacedevs.com/2.3.0/launchers/131/?format=api",
            "flight_proven": true,
            "serial_number": "38",
            "is_placeholder": false,
            "status": {
                "id": 2,
                "name": "expended"
            },
            "image": {
                "id": 1558,
                "name": "[AUTO] 38 - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/none_image_20230824130217.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193134.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "details": "Booster was expened during the Scout's Arrow HASTE launch",
            "successful_landings": 0,
            "attempted_landings": 0,
            "flights": 1,
            "last_launch_date": "2023-06-18T01:24:00Z",
            "first_launch_date": "2023-06-18T01:24:00Z",
            "fastest_turnaround": null
        },
        {
            "response_mode": "normal",
            "id": 132,
            "url": "https://ll.thespacedevs.com/2.3.0/launchers/132/?format=api",
            "flight_proven": true,
            "serial_number": "37",
            "is_placeholder": false,
            "status": {
                "id": 2,
                "name": "expended"
            },
            "image": {
                "id": 1557,
                "name": "[AUTO] 37 - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/none_image_20230824175716.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193132.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "details": "Booster expended on the \"Coming To A Storm Near You\" mission",
            "successful_landings": 0,
            "attempted_landings": 0,
            "flights": 1,
            "last_launch_date": "2023-05-26T03:46:00Z",
            "first_launch_date": "2023-05-26T03:46:00Z",
            "fastest_turnaround": null
        }
    ]
}