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

{
    "count": 451,
    "next": null,
    "previous": "https://lldev.thespacedevs.com/2.2.0/launch/?format=api&limit=10&offset=440&ordering=name",
    "results": [
        {
            "id": "bc6530e6-f53e-4621-8336-3838403737d9",
            "url": "https://lldev.thespacedevs.com/2.2.0/launch/bc6530e6-f53e-4621-8336-3838403737d9/?format=api",
            "slug": "zhuque-2e-unknown-payload",
            "name": "Zhuque-2E | Unknown Payload",
            "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": "2025-09-05T06:23:01Z",
            "net": "2025-08-15T01:17:00Z",
            "window_end": "2025-08-15T01:29:00Z",
            "window_start": "2025-08-15T01:08:00Z",
            "net_precision": {
                "id": 1,
                "name": "Minute",
                "abbrev": "MIN",
                "description": "The T-0 is accurate to the minute."
            },
            "probability": null,
            "weather_concerns": null,
            "holdreason": "",
            "failreason": "2nd stage attitude control failed at T+258 seconds due to TVC system short circuit, caused by electric arcing on the control system's 450V main bus.",
            "hashtag": null,
            "launch_service_provider": {
                "id": 259,
                "url": "https://lldev.thespacedevs.com/2.2.0/agencies/259/?format=api",
                "name": "LandSpace",
                "type": "Commercial"
            },
            "rocket": {
                "id": 8679,
                "configuration": {
                    "id": 519,
                    "url": "https://lldev.thespacedevs.com/2.2.0/config/launcher/519/?format=api",
                    "name": "Zhuque-2E",
                    "family": "Zhuque",
                    "full_name": "Zhuque-2E",
                    "variant": "2E"
                }
            },
            "mission": {
                "id": 7271,
                "name": "Unknown Payload",
                "description": "Details TBD.",
                "launch_designator": null,
                "type": "Unknown",
                "orbit": {
                    "id": 25,
                    "name": "Unknown",
                    "abbrev": "N/A"
                },
                "agencies": [],
                "info_urls": [],
                "vid_urls": []
            },
            "pad": {
                "id": 9,
                "url": "https://lldev.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://lldev.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-dev.nyc3.digitaloceanspaces.com/media/map_images/location_17_20200803142429.jpg",
                    "timezone_name": "Asia/Shanghai",
                    "total_launch_count": 258,
                    "total_landing_count": 0
                },
                "country_code": "CHN",
                "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_9_20200803143341.jpg",
                "total_launch_count": 6,
                "orbital_launch_attempt_count": 6
            },
            "webcast_live": false,
            "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/zhunque_2e_on_t_image_20241216101643.jpg",
            "infographic": null,
            "program": [],
            "orbital_launch_attempt_count": 7031,
            "location_launch_attempt_count": 255,
            "pad_launch_attempt_count": 6,
            "agency_launch_attempt_count": 7,
            "orbital_launch_attempt_count_year": 182,
            "location_launch_attempt_count_year": 16,
            "pad_launch_attempt_count_year": 2,
            "agency_launch_attempt_count_year": 2,
            "type": "normal"
        }
    ]
}