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

{
    "count": 7821,
    "next": null,
    "previous": "https://ll.thespacedevs.com/2.2.0/launch/?format=api&limit=10&offset=7810&ordering=last_updated",
    "results": [
        {
            "id": "aec64478-97b7-422d-93ef-2a8b0ffc8c5a",
            "url": "https://ll.thespacedevs.com/2.2.0/launch/aec64478-97b7-422d-93ef-2a8b0ffc8c5a/?format=api",
            "slug": "long-march-2c-unknown-payload",
            "name": "Long March 2C | Unknown Payload",
            "status": {
                "id": 1,
                "name": "Go for Launch",
                "abbrev": "Go",
                "description": "Current T-0 confirmed by official or reliable sources."
            },
            "last_updated": "2026-03-21T20:25:09Z",
            "net": "2026-03-27T04:10:00Z",
            "window_end": "2026-03-27T04:38:00Z",
            "window_start": "2026-03-27T04: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": 88,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/88/?format=api",
                "name": "China Aerospace Science and Technology Corporation",
                "type": "Government"
            },
            "rocket": {
                "id": 8949,
                "configuration": {
                    "id": 61,
                    "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/61/?format=api",
                    "name": "Long March 2C",
                    "family": "Long March",
                    "full_name": "Long March 2C",
                    "variant": "C"
                }
            },
            "mission": {
                "id": 7544,
                "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": 22,
                "url": "https://ll.thespacedevs.com/2.2.0/pad/22/?format=api",
                "agency_id": null,
                "name": "Launch Area 94 (SLS-2 / 603)",
                "description": "",
                "info_url": null,
                "wiki_url": "https://en.wikipedia.org/wiki/Jiuquan_Launch_Area_4",
                "map_url": "https://www.google.com/maps?q=40.960482,100.298059",
                "latitude": "40.960482",
                "longitude": "100.298059",
                "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": 278,
                    "total_landing_count": 2
                },
                "country_code": "CHN",
                "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_22_20200803143437.jpg",
                "total_launch_count": 134,
                "orbital_launch_attempt_count": 134
            },
            "webcast_live": false,
            "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long_march_2_image_20230803100234.jpeg",
            "infographic": null,
            "program": [],
            "orbital_launch_attempt_count": 7242,
            "location_launch_attempt_count": 279,
            "pad_launch_attempt_count": 135,
            "agency_launch_attempt_count": 581,
            "orbital_launch_attempt_count_year": 69,
            "location_launch_attempt_count_year": 6,
            "pad_launch_attempt_count_year": 3,
            "agency_launch_attempt_count_year": 11,
            "type": "normal"
        }
    ]
}