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

{
    "count": 7501,
    "next": null,
    "previous": "https://ll.thespacedevs.com/2.2.0/launch/?format=api&limit=10&offset=7490&ordering=last_updated",
    "results": [
        {
            "id": "35cd0984-b80f-4bc9-9d7a-ead47a40bccd",
            "url": "https://ll.thespacedevs.com/2.2.0/launch/35cd0984-b80f-4bc9-9d7a-ead47a40bccd/?format=api",
            "slug": "zhuque-2e-unknown-payload",
            "name": "Zhuque-2E | Unknown Payload",
            "status": {
                "id": 1,
                "name": "Go for Launch",
                "abbrev": "Go",
                "description": "Current T-0 confirmed by official or reliable sources."
            },
            "last_updated": "2025-05-16T03:41:50Z",
            "net": "2025-05-17T04:15:00Z",
            "window_end": "2025-05-17T04:40:00Z",
            "window_start": "2025-05-17T04:04:00Z",
            "net_precision": {
                "id": 2,
                "name": "Hour",
                "abbrev": "HR",
                "description": "The T-0 is accurate to the hour."
            },
            "probability": null,
            "weather_concerns": null,
            "holdreason": "",
            "failreason": "",
            "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": 8610,
                "configuration": {
                    "id": 519,
                    "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/519/?format=api",
                    "name": "Zhuque-2E",
                    "family": "Zhuque",
                    "full_name": "Zhuque-2E",
                    "variant": "2E"
                }
            },
            "mission": {
                "id": 7202,
                "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://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": 249,
                    "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/zhunque_2e_on_t_image_20241216101643.jpg",
            "infographic": null,
            "program": [],
            "orbital_launch_attempt_count": 6955,
            "location_launch_attempt_count": 250,
            "pad_launch_attempt_count": 5,
            "agency_launch_attempt_count": 6,
            "orbital_launch_attempt_count_year": 106,
            "location_launch_attempt_count_year": 11,
            "pad_launch_attempt_count_year": 1,
            "agency_launch_attempt_count_year": 1,
            "type": "normal"
        }
    ]
}