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=-net
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=-net",
    "results": [
        {
            "id": "e3df2ecd-c239-472f-95e4-2b89b4f75800",
            "url": "https://ll.thespacedevs.com/2.2.0/launch/e3df2ecd-c239-472f-95e4-2b89b4f75800/?format=api",
            "slug": "sputnik-8k74ps-sputnik-1",
            "name": "Sputnik 8K74PS | Sputnik 1",
            "status": {
                "id": 3,
                "name": "Launch Successful",
                "abbrev": "Success",
                "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)."
            },
            "last_updated": "2024-03-17T19:17:35Z",
            "net": "1957-10-04T19:28:34Z",
            "window_end": "1957-10-04T19:28:34Z",
            "window_start": "1957-10-04T19:28:34Z",
            "net_precision": null,
            "probability": null,
            "weather_concerns": null,
            "holdreason": "",
            "failreason": "",
            "hashtag": null,
            "launch_service_provider": {
                "id": 66,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/66/?format=api",
                "name": "Soviet Space Program",
                "type": "Government"
            },
            "rocket": {
                "id": 3003,
                "configuration": {
                    "id": 468,
                    "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/468/?format=api",
                    "name": "Sputnik 8K74PS",
                    "family": "Sputnik",
                    "full_name": "Sputnik 8K74PS",
                    "variant": "8K74PS"
                }
            },
            "mission": {
                "id": 1430,
                "name": "Sputnik 1",
                "description": "First artificial satellite consisting of a 58 cm pressurized aluminium shell containing two 1 W transmitters for a total mass of 83.6 kg.",
                "launch_designator": null,
                "type": "Test Flight",
                "orbit": {
                    "id": 8,
                    "name": "Low Earth Orbit",
                    "abbrev": "LEO"
                },
                "agencies": [],
                "info_urls": [],
                "vid_urls": []
            },
            "pad": {
                "id": 32,
                "url": "https://ll.thespacedevs.com/2.2.0/pad/32/?format=api",
                "agency_id": null,
                "name": "1/5",
                "description": null,
                "info_url": null,
                "wiki_url": "",
                "map_url": "https://www.google.com/maps?q=45.92,63.342",
                "latitude": "45.92",
                "longitude": "63.342",
                "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_32_20200803143513.jpg",
                "total_launch_count": 487,
                "orbital_launch_attempt_count": 487
            },
            "webcast_live": false,
            "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/sputnik_8k74ps_image_20210830185541.jpg",
            "infographic": null,
            "program": [],
            "orbital_launch_attempt_count": 1,
            "location_launch_attempt_count": 1,
            "pad_launch_attempt_count": 1,
            "agency_launch_attempt_count": 1,
            "orbital_launch_attempt_count_year": 1,
            "location_launch_attempt_count_year": 1,
            "pad_launch_attempt_count_year": 1,
            "agency_launch_attempt_count_year": 1,
            "type": "normal"
        }
    ]
}