GET

Launch List

AN API endpoint that returns all Launch objects or a single launch.

EXAMPLE - /launch/[id]/ or /launch/?mode=list&search=SpaceX

GET Return a list of all Launch objects.

FILTERS Fields - 'name', 'id(s)', 'lsp__id', 'lsp__name', 'serial_number', 'launcher_config__id', 'rocket__spacecraftflight__spacecraft__name', 'is_crewed', 'include_suborbital', 'spacecraft_config__ids', 'related', 'location__ids', 'lsp__ids', 'pad__ids', 'status__ids'

MODE 'normal', 'list', 'detailed'

EXAMPLE ?mode=list

SEARCH Searches through the launch name, rocket name, launch agency, mission name & spacecraft name.

EXAMPLE - ?search=SpaceX

GET /2.2.0/launch/?format=api&offset=7490&ordering=name
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "count": 7491,
    "next": null,
    "previous": "https://ll.thespacedevs.com/2.2.0/launch/?format=api&limit=10&offset=7480&ordering=name",
    "results": [
        {
            "id": "86ea974e-6464-4960-85df-11af88852d57",
            "url": "https://ll.thespacedevs.com/2.2.0/launch/86ea974e-6464-4960-85df-11af88852d57/?format=api",
            "slug": "zhuque-2-maiden-flight",
            "name": "Zhuque-2 | Maiden Flight",
            "status": {
                "id": 4,
                "name": "Launch Failure",
                "abbrev": "Failure",
                "description": "Either the launch vehicle did not reach orbit, or the payload(s) failed to separate."
            },
            "last_updated": "2024-03-05T18:05:43Z",
            "net": "2022-12-14T08:30:25Z",
            "window_end": "2022-12-14T10:44:00Z",
            "window_start": "2022-12-14T08:22:00Z",
            "net_precision": null,
            "probability": -1,
            "weather_concerns": null,
            "holdreason": "",
            "failreason": "Second-stage vernier engines unexpectedly shut down during second stage main engine cut-off after LOX pump casing was broken by SECO-induced forces at the LOX inlet; the vernier engines were planned to continue firing to reach orbit.",
            "hashtag": null,
            "launch_service_provider": {
                "id": 259,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/259/?format=api",
                "name": "LandSpace",
                "type": "Commercial"
            },
            "rocket": {
                "id": 2514,
                "configuration": {
                    "id": 199,
                    "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/199/?format=api",
                    "name": "Zhuque-2",
                    "family": "Zhuque",
                    "full_name": "Zhuque-2",
                    "variant": ""
                }
            },
            "mission": {
                "id": 1026,
                "name": "Maiden Flight",
                "description": "First flight of the new methalox rocket developed by Chinese startup LandSpace.",
                "launch_designator": null,
                "type": "Test Flight",
                "orbit": {
                    "id": 8,
                    "name": "Low Earth Orbit",
                    "abbrev": "LEO"
                },
                "agencies": [],
                "info_urls": [],
                "vid_urls": []
            },
            "pad": {
                "id": 9,
                "url": "https://ll.thespacedevs.com/2.2.0/pad/9/?format=api",
                "agency_id": 259,
                "name": "Launch Area 96",
                "description": "",
                "info_url": null,
                "wiki_url": "https://en.wikipedia.org/wiki/LandSpace",
                "map_url": "https://www.google.com/maps?q=40.91491,100.245488",
                "latitude": "40.91491",
                "longitude": "100.245488",
                "location": {
                    "id": 17,
                    "url": "https://ll.thespacedevs.com/2.2.0/location/17/?format=api",
                    "name": "Jiuquan Satellite Launch Center, People's Republic of China",
                    "country_code": "CHN",
                    "description": "Jiuquan Satellite Launch Center is a Chinese spaceport located between the Ejin, Alxa, Inner Mongolia and Hangtian Town, Jinta County, Jiuquan, Gansu Province. It is part of the Dongfeng Aerospace City (Base 10).",
                    "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_17_20200803142429.jpg",
                    "timezone_name": "Asia/Shanghai",
                    "total_launch_count": 248,
                    "total_landing_count": 0
                },
                "country_code": "CHN",
                "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_9_20200803143341.jpg",
                "total_launch_count": 4,
                "orbital_launch_attempt_count": 4
            },
            "webcast_live": false,
            "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/zhuque-225202_image_20230802052349.jpg",
            "infographic": null,
            "program": [],
            "orbital_launch_attempt_count": 6358,
            "location_launch_attempt_count": 182,
            "pad_launch_attempt_count": 1,
            "agency_launch_attempt_count": 2,
            "orbital_launch_attempt_count_year": 176,
            "location_launch_attempt_count_year": 25,
            "pad_launch_attempt_count_year": 1,
            "agency_launch_attempt_count_year": 1,
            "type": "normal"
        }
    ]
}