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/89f9600b-b250-4b0f-a713-99b123bb58d8/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "89f9600b-b250-4b0f-a713-99b123bb58d8",
    "url": "https://ll.thespacedevs.com/2.2.0/launch/89f9600b-b250-4b0f-a713-99b123bb58d8/?format=api",
    "slug": "electron-four-of-a-kind-northstar-1",
    "flightclub_url": null,
    "r_spacex_api_id": null,
    "name": "Electron | Four Of A Kind (NorthStar 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-05T17:48:44Z",
    "updates": [
        {
            "id": 6523,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Launch success.",
            "info_url": "https://northstar-data.com/successful-launch-of-northstar-1-space-based-ssa/",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-01-31T09:08:51Z"
        },
        {
            "id": 6522,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Liftoff.",
            "info_url": "https://www.youtube.com/watch?v=NDyxRPGWhRo",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-01-31T06:35:48Z"
        },
        {
            "id": 6521,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "New T-0.",
            "info_url": "https://twitter.com/RocketLab/status/1752574200374837505",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-01-31T06:07:48Z"
        },
        {
            "id": 6520,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/ll2_profile_20230311134739.png",
            "comment": "Livestream has started",
            "info_url": "https://www.youtube.com/watch?v=NDyxRPGWhRo",
            "created_by": "LL2",
            "created_on": "2024-01-31T05:50:03Z"
        },
        {
            "id": 6519,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg",
            "comment": "Adjusting T-0",
            "info_url": "https://twitter.com/rocketlab/status/1752484932629471410",
            "created_by": "SwGustav",
            "created_on": "2024-01-31T00:45:49Z"
        },
        {
            "id": 6492,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg",
            "comment": "Delayed to 31st due to weather",
            "info_url": "https://twitter.com/RocketLab/status/1751422799040966902",
            "created_by": "SwGustav",
            "created_on": "2024-01-28T02:22:34Z"
        },
        {
            "id": 6479,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg",
            "comment": "Delayed due to weather",
            "info_url": "https://twitter.com/RocketLab/status/1750657277798060222",
            "created_by": "SwGustav",
            "created_on": "2024-01-26T02:24:40Z"
        },
        {
            "id": 6362,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Delayed to NET January 27.",
            "info_url": "https://twitter.com/rocketlab/status/1747497051519406549",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-01-17T06:05:25Z"
        },
        {
            "id": 6214,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
            "comment": "Adding launch window and setting GO",
            "info_url": "https://www.rocketlabusa.com/assets/Uploads/Four-Of-A-Kind-Press-Kit-final.pdf",
            "created_by": "Nosu",
            "created_on": "2024-01-08T21:51:26Z"
        },
        {
            "id": 6190,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "NET January 2024.",
            "info_url": "https://northstar-data.com/",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-01-06T00:26:00Z"
        },
        {
            "id": 5923,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "NET early 2024.",
            "info_url": "https://www.spaceintelreport.com/latest-funding-means-space-situational-awareness-startup-northstar-is-funded-through-launch-of-first-4-satellites/",
            "created_by": "Cosmic_Penguin",
            "created_on": "2023-12-10T17:16:11Z"
        },
        {
            "id": 5199,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
            "comment": "TBD 2023 pending return to flight with The Moon God Awakens after the launch failure of We Will Never Desert You.",
            "info_url": "https://www.businesswire.com/news/home/20230919303915/en/Rocket-Lab-Launch-Update",
            "created_by": "Nosu",
            "created_on": "2023-09-19T08:57:51Z"
        },
        {
            "id": 4458,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "NET September 2023.",
            "info_url": "https://www.rocketlabusa.com/missions/upcoming-missions/northstar-and-spire/",
            "created_by": "Cosmic_Penguin",
            "created_on": "2023-06-22T15:06:26Z"
        },
        {
            "id": 4444,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
            "comment": "Adding launch NET late 2023",
            "info_url": "https://spacenews.com/northstar-pivots-to-rocket-lab-following-virgin-orbits-collapse/",
            "created_by": "Nosu",
            "created_on": "2023-06-22T06:19:03Z"
        }
    ],
    "net": "2024-01-31T06:34:00Z",
    "net_precision": {
        "id": 1,
        "name": "Minute",
        "abbrev": "MIN",
        "description": "The T-0 is accurate to the minute."
    },
    "window_end": "2024-01-31T07:00:00Z",
    "window_start": "2024-01-31T06:15:00Z",
    "probability": null,
    "weather_concerns": null,
    "holdreason": "",
    "failreason": "",
    "hashtag": null,
    "launch_service_provider": {
        "id": 147,
        "url": "https://ll.thespacedevs.com/2.2.0/agencies/147/?format=api",
        "name": "Rocket Lab",
        "featured": true,
        "type": "Commercial",
        "country_code": "USA",
        "abbrev": "RL",
        "description": "Rocket Lab is an American aerospace manufacturer with a wholly owned New Zealand subsidiary. The company develops lightweight, cost-effective commercial rocket launch services. The Electron Program was founded on the premise that small payloads such as CubeSats require dedicated small launch vehicles and flexibility not currently offered by traditional rocket systems. Its rocket, the Electron, is a light-weight rocket and is now operating commercially. The company is also producing a variety of spacecrafts and spacecrafts components.",
        "administrator": "CEO: Peter Beck",
        "founding_year": "2006",
        "launchers": "Electron",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 64,
        "consecutive_successful_launches": 23,
        "successful_launches": 60,
        "failed_launches": 4,
        "pending_launches": 33,
        "consecutive_successful_landings": 4,
        "successful_landings": 7,
        "failed_landings": 2,
        "attempted_landings": 9,
        "info_url": "http://www.rocketlabusa.com/",
        "wiki_url": "http://en.wikipedia.org/wiki/Rocket_Lab",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_logo_20220218075411.png",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_image_20190207032456.jpeg",
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_nation_20230531050352.jpg"
    },
    "rocket": {
        "id": 7940,
        "configuration": {
            "id": 26,
            "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/26/?format=api",
            "name": "Electron",
            "active": true,
            "reusable": false,
            "description": "Electron is a two-stage orbital expendable launch vehicle (with an optional third stage) developed by the American aerospace company Rocket Lab. Electron is a small-lift launch vehicle designed to launch small satellites and cubesats to sun-synchronous orbit and low earth orbit. The Electron is the first orbital class rocket to use electric-pump-fed engines, powered by the 9 Rutherford engines on the first stage. It is also used as a suborbital testbed (called HASTE) for hypersonics research.",
            "family": "",
            "full_name": "Electron",
            "manufacturer": {
                "id": 147,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/147/?format=api",
                "name": "Rocket Lab",
                "featured": true,
                "type": "Commercial",
                "country_code": "USA",
                "abbrev": "RL",
                "description": "Rocket Lab is an American aerospace manufacturer with a wholly owned New Zealand subsidiary. The company develops lightweight, cost-effective commercial rocket launch services. The Electron Program was founded on the premise that small payloads such as CubeSats require dedicated small launch vehicles and flexibility not currently offered by traditional rocket systems. Its rocket, the Electron, is a light-weight rocket and is now operating commercially. The company is also producing a variety of spacecrafts and spacecrafts components.",
                "administrator": "CEO: Peter Beck",
                "founding_year": "2006",
                "launchers": "Electron",
                "spacecraft": "",
                "launch_library_url": null,
                "total_launch_count": 64,
                "consecutive_successful_launches": 23,
                "successful_launches": 60,
                "failed_launches": 4,
                "pending_launches": 33,
                "consecutive_successful_landings": 4,
                "successful_landings": 7,
                "failed_landings": 2,
                "attempted_landings": 9,
                "info_url": "http://www.rocketlabusa.com/",
                "wiki_url": "http://en.wikipedia.org/wiki/Rocket_Lab",
                "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_logo_20220218075411.png",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_image_20190207032456.jpeg",
                "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rocket2520lab2520ltd_nation_20230531050352.jpg"
            },
            "program": [],
            "variant": "",
            "alias": "",
            "min_stage": 2,
            "max_stage": 3,
            "length": 18.0,
            "diameter": 1.2,
            "maiden_flight": "2017-05-25",
            "launch_cost": "6000000",
            "launch_mass": 13,
            "leo_capacity": 300,
            "gto_capacity": null,
            "to_thrust": 162,
            "apogee": null,
            "vehicle_range": null,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/electron_image_20190705175640.jpeg",
            "info_url": "https://www.rocketlabusa.com/electron/",
            "wiki_url": "https://en.wikipedia.org/wiki/Rocket_Lab_Electron",
            "total_launch_count": 64,
            "consecutive_successful_launches": 23,
            "successful_launches": 60,
            "failed_launches": 4,
            "pending_launches": 31,
            "attempted_landings": 9,
            "successful_landings": 7,
            "failed_landings": 2,
            "consecutive_successful_landings": 4
        },
        "launcher_stage": [
            {
                "id": 488,
                "type": "Core",
                "reused": false,
                "launcher_flight_number": 1,
                "launcher": {
                    "id": 146,
                    "url": "https://ll.thespacedevs.com/2.2.0/launcher/146/?format=api",
                    "details": "Booster used for the \"Four Of A Kind\" mission.",
                    "flight_proven": true,
                    "serial_number": "43",
                    "status": "active",
                    "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/146_image_20240119075144.jpeg",
                    "successful_landings": 1,
                    "attempted_landings": 1,
                    "flights": 1,
                    "last_launch_date": "2024-01-31T06:34:00Z",
                    "first_launch_date": "2024-01-31T06:34:00Z"
                },
                "landing": {
                    "id": 1298,
                    "attempt": true,
                    "success": true,
                    "description": "The Electron booster was successfully recovered after a soft parachute splashdown in the Pacific Ocean.",
                    "downrange_distance": null,
                    "location": {
                        "id": 18,
                        "name": "Pacific Ocean",
                        "abbrev": "PAC",
                        "description": "Pacific Ocean",
                        "location": null,
                        "successful_landings": 46
                    },
                    "type": {
                        "id": 4,
                        "name": "Parachute Landing",
                        "abbrev": "PCL",
                        "description": "Unpowered landing using parachute(s)."
                    }
                },
                "previous_flight_date": null,
                "turn_around_time_days": null,
                "previous_flight": null
            }
        ],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 6449,
        "name": "Four Of A Kind (NorthStar 1)",
        "description": "Four space situational awareness (SSA) satellites for Canadian company NorthStar Earth and Space.",
        "launch_designator": null,
        "type": "Space Situational Awareness",
        "orbit": {
            "id": 8,
            "name": "Low Earth Orbit",
            "abbrev": "LEO"
        },
        "agencies": [
            {
                "id": 1060,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/1060/?format=api",
                "name": "Northstar Earth & Space",
                "featured": false,
                "type": "Private",
                "country_code": "CAN",
                "abbrev": "Northstar",
                "description": "NorthStar seeks to empower humanity to preserve our planet through a unique Space and Earth information & intelligence platform using space-based sensors. NorthStar strives to help transform the way governments, industry and institutions assess risk, enforce regulations and make decisions to foster the sustainable development of our planet and deliver a safe and secure near-Earth environment.",
                "administrator": "Founder:  Stewart Bain",
                "founding_year": "2015",
                "launchers": "",
                "spacecraft": "",
                "launch_library_url": null,
                "total_launch_count": 0,
                "consecutive_successful_launches": 0,
                "successful_launches": 0,
                "failed_launches": 0,
                "pending_launches": 0,
                "consecutive_successful_landings": 0,
                "successful_landings": 0,
                "failed_landings": 0,
                "attempted_landings": 0,
                "info_url": "https://northstar-data.com/",
                "wiki_url": null,
                "logo_url": null,
                "image_url": null,
                "nation_url": null
            }
        ],
        "info_urls": [],
        "vid_urls": []
    },
    "pad": {
        "id": 185,
        "url": "https://ll.thespacedevs.com/2.2.0/pad/185/?format=api",
        "agency_id": 147,
        "name": "Rocket Lab Launch Complex 1B",
        "description": "",
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/Rocket_Lab_Launch_Complex_1",
        "map_url": "https://www.google.com/maps?q=-39.262833,177.864469",
        "latitude": "-39.262833",
        "longitude": "177.864469",
        "location": {
            "id": 10,
            "url": "https://ll.thespacedevs.com/2.2.0/location/10/?format=api",
            "name": "Rocket Lab Launch Complex 1, Mahia Peninsula, New Zealand",
            "country_code": "NZL",
            "description": "Rocket Lab Launch Complex 1 is a commercial spaceport located close to Ahuriri Point at the southern tip of Māhia Peninsula, on the east coast of New Zealand's North Island. It is owned and operated by private spaceflight company Rocket Lab and supports launches of the company's Electron rocket for small satellites. With the launch of Electron on 25 May 2017, it became the first private spaceport to host an orbital launch attempt, and the first site in New Zealand to host an orbital launch attempt. With the Electron launch of 21 January 2018, it became the first private spaceport to host a successful orbital launch.",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_10_20200803142509.jpg",
            "timezone_name": "Pacific/Auckland",
            "total_launch_count": 58,
            "total_landing_count": 17
        },
        "country_code": "NZL",
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_185_20200803143540.jpg",
        "total_launch_count": 28,
        "orbital_launch_attempt_count": 28
    },
    "infoURLs": [
        {
            "priority": 10,
            "source": "rocketlabusa.com",
            "title": "Four Of A Kind Press Kit",
            "description": "Official Mission Press Kit",
            "feature_image": null,
            "url": "https://www.rocketlabusa.com/assets/Uploads/F43-Four-Of-A-Kind-Press-Kit.pdf",
            "type": {
                "id": 2,
                "name": "Official Press Kit"
            },
            "language": {
                "id": 1,
                "name": "English",
                "code": "en"
            }
        }
    ],
    "vidURLs": [
        {
            "priority": 10,
            "source": "youtube.com",
            "publisher": "Rocket Lab",
            "title": "Rocket Lab \"Four Of A Kind\" Launch",
            "description": "",
            "feature_image": "https://i.ytimg.com/vi/NDyxRPGWhRo/maxresdefault_live.jpg",
            "url": "https://www.youtube.com/watch?v=NDyxRPGWhRo",
            "type": {
                "id": 1,
                "name": "Official Webcast"
            },
            "language": {
                "id": 1,
                "name": "English",
                "code": "en"
            },
            "start_time": "2024-01-31T05:47:48Z",
            "end_time": "2024-01-31T07:29:21Z"
        }
    ],
    "webcast_live": false,
    "timeline": [
        {
            "type": {
                "id": 6,
                "abbrev": "Startup",
                "description": "The onboard computer takes control over the countdown and runs last checks"
            },
            "relative_time": "-PT2M"
        },
        {
            "type": {
                "id": 9,
                "abbrev": "Ignition",
                "description": "Start of the engine ignition sequence"
            },
            "relative_time": "-PT2S"
        },
        {
            "type": {
                "id": 10,
                "abbrev": "Liftoff",
                "description": "First upwards movement of the rocket"
            },
            "relative_time": "P0D"
        },
        {
            "type": {
                "id": 25,
                "abbrev": "Supersonic",
                "description": "Vehicle is supersonic"
            },
            "relative_time": "PT55S"
        },
        {
            "type": {
                "id": 11,
                "abbrev": "Max-Q",
                "description": "Maximum dynamic pressure"
            },
            "relative_time": "PT1M7S"
        },
        {
            "type": {
                "id": 12,
                "abbrev": "MECO",
                "description": "Cut-off of the main engine"
            },
            "relative_time": "PT2M25S"
        },
        {
            "type": {
                "id": 13,
                "abbrev": "Stage 2 Separation",
                "description": "Separation of the second stage from the first"
            },
            "relative_time": "PT2M28S"
        },
        {
            "type": {
                "id": 31,
                "abbrev": "SES",
                "description": "Start of the second engine"
            },
            "relative_time": "PT2M31S"
        },
        {
            "type": {
                "id": 15,
                "abbrev": "Fairing Separation",
                "description": "Separation of the payload fairing"
            },
            "relative_time": "PT3M7S"
        },
        {
            "type": {
                "id": 26,
                "abbrev": "Stage 1 Apogee",
                "description": "Highest altitude of the first stage's flight"
            },
            "relative_time": "PT4M26S"
        },
        {
            "type": {
                "id": 27,
                "abbrev": "Stage 1 Drogue",
                "description": "Deployment of the first stage's drogue parachute"
            },
            "relative_time": "PT7M8S"
        },
        {
            "type": {
                "id": 28,
                "abbrev": "Stage 1 Subsonic",
                "description": "The first stage has slowed down to subsonic speeds"
            },
            "relative_time": "PT7M25S"
        },
        {
            "type": {
                "id": 29,
                "abbrev": "Stage 1 Parachute",
                "description": "Deployment of the first stage's main parachute"
            },
            "relative_time": "PT8M"
        },
        {
            "type": {
                "id": 24,
                "abbrev": "SECO",
                "description": "Cut-off of the second engine"
            },
            "relative_time": "PT9M20S"
        },
        {
            "type": {
                "id": 30,
                "abbrev": "Kick Stage Separation",
                "description": "Separation of the kick stage from the previous stage"
            },
            "relative_time": "PT9M24S"
        },
        {
            "type": {
                "id": 34,
                "abbrev": "Stage 1 Splashdown",
                "description": "Splashdown of the first stage"
            },
            "relative_time": "PT18M4S"
        },
        {
            "type": {
                "id": 32,
                "abbrev": "Kick Stage Ignition",
                "description": "Start of the kick stage engine"
            },
            "relative_time": "PT48M23S"
        },
        {
            "type": {
                "id": 33,
                "abbrev": "Kick Stage Cut-off",
                "description": "Cut-off of the kick stage engine"
            },
            "relative_time": "PT50M27S"
        },
        {
            "type": {
                "id": 35,
                "abbrev": "Payload Separation",
                "description": "Final deployment of the payload from the rocket"
            },
            "relative_time": "PT1H17M"
        }
    ],
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/electron25202_image_20240128092657.jpeg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 6611,
    "location_launch_attempt_count": 40,
    "pad_launch_attempt_count": 14,
    "agency_launch_attempt_count": 43,
    "orbital_launch_attempt_count_year": 22,
    "location_launch_attempt_count_year": 1,
    "pad_launch_attempt_count_year": 1,
    "agency_launch_attempt_count_year": 1,
    "pad_turnaround": "P47DT2H28M6S",
    "mission_patches": [
        {
            "id": 972,
            "name": "Four Of A Kind Patch",
            "priority": 10,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/four2520of252_mission_patch_20240108215220.png",
            "agency": {
                "id": 147,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/147/?format=api",
                "name": "Rocket Lab",
                "type": "Commercial"
            }
        }
    ],
    "type": "detailed"
}