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=last_updated
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=last_updated",
    "results": [
        {
            "id": "49678ae6-8664-4d60-9aa2-622c087ed917",
            "url": "https://ll.thespacedevs.com/2.2.0/launch/49678ae6-8664-4d60-9aa2-622c087ed917/?format=api",
            "slug": "soyuz-21a-bion-m-no-2",
            "name": "Soyuz 2.1a | Bion-M No. 2",
            "status": {
                "id": 2,
                "name": "To Be Determined",
                "abbrev": "TBD",
                "description": "Current date is a placeholder or rough estimation based on unreliable or interpreted sources."
            },
            "last_updated": "2025-05-08T08:21:51Z",
            "net": "2025-07-20T00:00:00Z",
            "window_end": "2025-07-20T00:00:00Z",
            "window_start": "2025-07-20T00:00:00Z",
            "net_precision": {
                "id": 5,
                "name": "Day",
                "abbrev": "DAY",
                "description": "The T-0 is expected on the given day."
            },
            "probability": null,
            "weather_concerns": null,
            "holdreason": "",
            "failreason": "",
            "hashtag": null,
            "launch_service_provider": {
                "id": 63,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/63/?format=api",
                "name": "Russian Federal Space Agency (ROSCOSMOS)",
                "type": "Government"
            },
            "rocket": {
                "id": 8083,
                "configuration": {
                    "id": 24,
                    "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/24/?format=api",
                    "name": "Soyuz 2.1a",
                    "family": "Soyuz",
                    "full_name": "Soyuz 2.1a",
                    "variant": ""
                }
            },
            "mission": {
                "id": 6637,
                "name": "Bion-M No. 2",
                "description": "Bion-M is the next generation of Russian biological research satellites. While retaining the Vostok/Zenit-derived reentry module of the earlier Bion, the propulsion module has been replace by a Yantar type module, which provides maneuvering capabilities and longer mission support. The mission duration has been increased to up to 6 months by using solar cells for energy generation. The weight of scientific equipment has been increased by 100 kilograms.",
                "launch_designator": null,
                "type": "Biology",
                "orbit": {
                    "id": 8,
                    "name": "Low Earth Orbit",
                    "abbrev": "LEO"
                },
                "agencies": [],
                "info_urls": [],
                "vid_urls": []
            },
            "pad": {
                "id": 20,
                "url": "https://ll.thespacedevs.com/2.2.0/pad/20/?format=api",
                "agency_id": null,
                "name": "31/6",
                "description": "",
                "info_url": null,
                "wiki_url": "https://en.wikipedia.org/wiki/Baikonur_Cosmodrome_Site_31",
                "map_url": "https://www.google.com/maps?q=45.996034,63.564003",
                "latitude": "45.996034",
                "longitude": "63.564003",
                "location": {
                    "id": 15,
                    "url": "https://ll.thespacedevs.com/2.2.0/location/15/?format=api",
                    "name": "Baikonur Cosmodrome, Republic of Kazakhstan",
                    "country_code": "KAZ",
                    "description": "The Baikonur Cosmodrome is a spaceport operated by Russia within Kazakhstan. Located in the Kazakh city of Baikonur, it is the largest operational space launch facility in terms of area. All Russian crewed spaceflights are launched from Baikonur.",
                    "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_15_20200803142517.jpg",
                    "timezone_name": "Asia/Qyzylorda",
                    "total_launch_count": 1555,
                    "total_landing_count": 0
                },
                "country_code": "KAZ",
                "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_20_20200803143516.jpg",
                "total_launch_count": 422,
                "orbital_launch_attempt_count": 422
            },
            "webcast_live": false,
            "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_2.1a_image_20230805184309.jpg",
            "infographic": null,
            "program": [],
            "orbital_launch_attempt_count": 6976,
            "location_launch_attempt_count": 1557,
            "pad_launch_attempt_count": 424,
            "agency_launch_attempt_count": 333,
            "orbital_launch_attempt_count_year": 127,
            "location_launch_attempt_count_year": 4,
            "pad_launch_attempt_count_year": 4,
            "agency_launch_attempt_count_year": 4,
            "type": "normal"
        }
    ]
}