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/a32fa9ec-7925-4698-bbc7-a7ed1ad12621/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "a32fa9ec-7925-4698-bbc7-a7ed1ad12621",
    "url": "https://ll.thespacedevs.com/2.2.0/launch/a32fa9ec-7925-4698-bbc7-a7ed1ad12621/?format=api",
    "slug": "delta-iv-heavy-nrol-70",
    "flightclub_url": "https://flightclub.io/result?llId=a32fa9ec-7925-4698-bbc7-a7ed1ad12621",
    "r_spacex_api_id": null,
    "name": "Delta IV Heavy | NROL-70",
    "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-04-10T04:52:18Z",
    "updates": [
        {
            "id": 7241,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg",
            "comment": "Launch success confirmed",
            "info_url": "https://twitter.com/ulalaunch/status/1777836560500596742",
            "created_by": "SwGustav",
            "created_on": "2024-04-09T23:19:12Z"
        },
        {
            "id": 7238,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/lucas2520stauder_profile_20230526163835.jpg",
            "comment": "Liftoff",
            "info_url": null,
            "created_by": "hitura-nobad",
            "created_on": "2024-04-09T16:53:39Z"
        },
        {
            "id": 7237,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/ll2_profile_20230311134739.png",
            "comment": "Official Webcast by United Launch Alliance has started",
            "info_url": "https://www.youtube.com/watch?v=aTh7dhCYZFE",
            "created_by": "LL2",
            "created_on": "2024-04-09T16:21:11Z"
        },
        {
            "id": 7225,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/lucas2520stauder_profile_20230526163835.jpg",
            "comment": "Weather 90% GO",
            "info_url": "https://www.patrick.spaceforce.mil/Portals/14/Weather/Delta%20IV%20Heavy%20L-70%20L-1%20Forecast%20-9%20Apr%20Launch.pdf?ver=1-AnnMiw0YGPIlfeGCPPWQ%3D%3D",
            "created_by": "hitura-nobad",
            "created_on": "2024-04-08T12:33:09Z"
        },
        {
            "id": 7193,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Rescheduled for April 9.",
            "info_url": "https://twitter.com/ulalaunch/status/1775222168822993163",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-04-02T18:11:05Z"
        },
        {
            "id": 7175,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "NET April 8.",
            "info_url": "https://www.fly.faa.gov/adv/adv_spt.jsp",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-03-31T15:36:37Z"
        },
        {
            "id": 7170,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Delayed beyond April 1st UTC.",
            "info_url": "https://forum.nasaspaceflight.com/index.php?topic=58567.msg2582088#msg2582088",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-03-31T07:03:33Z"
        },
        {
            "id": 7136,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "NET April 1st.",
            "info_url": "https://twitter.com/SpaceflightNow/status/1773502476253004196",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-03-29T00:26:32Z"
        },
        {
            "id": 7134,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Delayed beyond March 29, TBD.",
            "info_url": "https://twitter.com/ulalaunch/status/1773498611164160165",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-03-29T00:06:08Z"
        },
        {
            "id": 7133,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/lucas2520stauder_profile_20230526163835.jpg",
            "comment": "Setting GO",
            "info_url": "https://twitter.com/ulalaunch/status/1773430934601150817",
            "created_by": "hitura-nobad",
            "created_on": "2024-03-28T19:52:56Z"
        },
        {
            "id": 7131,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Scrubbed for the day, caused by a GN2 pipeline ground pump failure.",
            "info_url": "https://twitter.com/ulalaunch/status/1773421969557315653",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-03-28T18:49:52Z"
        },
        {
            "id": 7130,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Hold at T-3:58.",
            "info_url": "https://www.youtube.com/live/HCoyHHhX3rw",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-03-28T18:43:16Z"
        },
        {
            "id": 7127,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/ll2_profile_20230311134739.png",
            "comment": "Official Webcast by United Launch Alliance has started",
            "info_url": "https://www.youtube.com/watch?v=HCoyHHhX3rw",
            "created_by": "LL2",
            "created_on": "2024-03-28T18:12:48Z"
        },
        {
            "id": 7126,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "New T-0.",
            "info_url": "https://twitter.com/ulalaunch/status/1773378859045404724",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-03-28T16:00:10Z"
        },
        {
            "id": 7125,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "New T-0.",
            "info_url": "https://twitter.com/spaceflightnow/status/1773365966342107596",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-03-28T15:29:31Z"
        },
        {
            "id": 7088,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Weather 30% GO.",
            "info_url": "https://twitter.com/ulalaunch/status/1772261858159849775",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-03-25T14:57:20Z"
        },
        {
            "id": 7082,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Launch time confirmed by NRO.",
            "info_url": "https://twitter.com/NatReconOfc/status/1771914944184787084",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-03-24T15:11:18Z"
        },
        {
            "id": 7060,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Added tentative launch window per marine navigation warnings.",
            "info_url": "https://forum.nasaspaceflight.com/index.php?topic=58567.msg2579826#msg2579826",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-03-23T03:59:10Z"
        },
        {
            "id": 6949,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "NET March 28.",
            "info_url": "https://twitter.com/natreconofc/status/1767566328351674606",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-03-12T15:02:22Z"
        },
        {
            "id": 5145,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "NET March 2024.",
            "info_url": "https://beta.nasa.gov/news-release/nasa-stennis-aerojet-rocketdyne-closes-historic-commercial-test-partnership/",
            "created_by": "Cosmic_Penguin",
            "created_on": "2023-09-12T18:08:55Z"
        },
        {
            "id": 4429,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "NET February 2024.",
            "info_url": "https://www.nasaspaceflight.com/2023/06/delta-iv-heavy-nrol-68/",
            "created_by": "Cosmic_Penguin",
            "created_on": "2023-06-21T03:09:07Z"
        }
    ],
    "net": "2024-04-09T16:53:00Z",
    "net_precision": {
        "id": 1,
        "name": "Minute",
        "abbrev": "MIN",
        "description": "The T-0 is accurate to the minute."
    },
    "window_end": "2024-04-09T22:51:00Z",
    "window_start": "2024-04-09T16:53:00Z",
    "probability": 90,
    "weather_concerns": "Cumulus Cloud Rule",
    "holdreason": "",
    "failreason": "",
    "hashtag": null,
    "launch_service_provider": {
        "id": 124,
        "url": "https://ll.thespacedevs.com/2.2.0/agencies/124/?format=api",
        "name": "United Launch Alliance",
        "featured": true,
        "type": "Commercial",
        "country_code": "USA",
        "abbrev": "ULA",
        "description": "United Launch Alliance (ULA) is a joint venture of Lockheed Martin Space Systems and Boeing Defense, Space & Security. ULA was formed in December 2006 by combining the teams at these companies which provide spacecraft launch services to the government of the United States. ULA launches from both coasts of the US. They launch their Atlas V vehicle from LC-41 in Cape Canaveral and LC-3E at Vandeberg. Their Delta IV launches from LC-37 at Cape Canaveral and LC-6 at Vandenberg.",
        "administrator": "CEO: Tory Bruno",
        "founding_year": "2006",
        "launchers": "Atlas | Delta IV | Vulcan",
        "spacecraft": "CST-100 Starliner",
        "launch_library_url": null,
        "total_launch_count": 165,
        "consecutive_successful_launches": 165,
        "successful_launches": 165,
        "failed_launches": 0,
        "pending_launches": 44,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "http://www.ulalaunch.com/",
        "wiki_url": "http://en.wikipedia.org/wiki/United_Launch_Alliance",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_logo_20210412195953.png",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united_launch_a_image_20210412201210.png",
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_nation_20230531043703.jpg"
    },
    "rocket": {
        "id": 2534,
        "configuration": {
            "id": 21,
            "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/21/?format=api",
            "name": "Delta IV Heavy",
            "active": false,
            "reusable": false,
            "description": "The Delta IV Heavy (Delta 9250H) is an expendable heavy-lift launch vehicle, the largest type of the Delta IV family, and is the world's second highest-capacity rocket in operation. It is manufactured by United Launch Alliance and was first launched in 2004.",
            "family": "Delta",
            "full_name": "Delta IV Heavy",
            "manufacturer": {
                "id": 124,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/124/?format=api",
                "name": "United Launch Alliance",
                "featured": true,
                "type": "Commercial",
                "country_code": "USA",
                "abbrev": "ULA",
                "description": "United Launch Alliance (ULA) is a joint venture of Lockheed Martin Space Systems and Boeing Defense, Space & Security. ULA was formed in December 2006 by combining the teams at these companies which provide spacecraft launch services to the government of the United States. ULA launches from both coasts of the US. They launch their Atlas V vehicle from LC-41 in Cape Canaveral and LC-3E at Vandeberg. Their Delta IV launches from LC-37 at Cape Canaveral and LC-6 at Vandenberg.",
                "administrator": "CEO: Tory Bruno",
                "founding_year": "2006",
                "launchers": "Atlas | Delta IV | Vulcan",
                "spacecraft": "CST-100 Starliner",
                "launch_library_url": null,
                "total_launch_count": 165,
                "consecutive_successful_launches": 165,
                "successful_launches": 165,
                "failed_launches": 0,
                "pending_launches": 44,
                "consecutive_successful_landings": 0,
                "successful_landings": 0,
                "failed_landings": 0,
                "attempted_landings": 0,
                "info_url": "http://www.ulalaunch.com/",
                "wiki_url": "http://en.wikipedia.org/wiki/United_Launch_Alliance",
                "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_logo_20210412195953.png",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united_launch_a_image_20210412201210.png",
                "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_nation_20230531043703.jpg"
            },
            "program": [],
            "variant": "Heavy",
            "alias": "",
            "min_stage": 2,
            "max_stage": 2,
            "length": 72.0,
            "diameter": 5.0,
            "maiden_flight": "2004-12-21",
            "launch_cost": "350000000",
            "launch_mass": 733,
            "leo_capacity": 28370,
            "gto_capacity": 14210,
            "to_thrust": 8674,
            "apogee": 40000,
            "vehicle_range": null,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/delta_iv_heavy_image_20210426103838.jpg",
            "info_url": "https://www.ulalaunch.com/rockets/delta-iv",
            "wiki_url": "https://en.wikipedia.org/wiki/Delta_IV_Heavy",
            "total_launch_count": 16,
            "consecutive_successful_launches": 15,
            "successful_launches": 15,
            "failed_launches": 1,
            "pending_launches": 0,
            "attempted_landings": 0,
            "successful_landings": 0,
            "failed_landings": 0,
            "consecutive_successful_landings": 0
        },
        "launcher_stage": [],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 6494,
        "name": "NROL-70",
        "description": "Classified payload for the NRO.\r\nLast flight of the Delta IV Heavy rocket.",
        "launch_designator": null,
        "type": "Government/Top Secret",
        "orbit": {
            "id": 1,
            "name": "Geostationary Orbit",
            "abbrev": "Direct-GEO"
        },
        "agencies": [
            {
                "id": 181,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/181/?format=api",
                "name": "National Reconnaissance Office",
                "featured": false,
                "type": "Government",
                "country_code": "USA",
                "abbrev": "NRO",
                "description": "The National Reconnaissance Office (NRO) is a member of the United States Intelligence Community and an agency of the United States Department of Defense which designs, builds, launches, and operates the reconnaissance satellites of the U.S. federal government, and provides satellite intelligence to several government agencies, particularly signals intelligence (SIGINT) to the NSA, imagery intelligence (IMINT) to the NGA, and measurement and signature intelligence (MASINT) to the DIA.",
                "administrator": "Director: Christopher Scolese",
                "founding_year": "1961",
                "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": "http://www.nro.gov/",
                "wiki_url": "https://en.wikipedia.org/wiki/National_Reconnaissance_Office",
                "logo_url": null,
                "image_url": null,
                "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520reconnaissance2520office_nation_20240228092125.png"
            }
        ],
        "info_urls": [],
        "vid_urls": []
    },
    "pad": {
        "id": 38,
        "url": "https://ll.thespacedevs.com/2.2.0/pad/38/?format=api",
        "agency_id": null,
        "name": "Space Launch Complex 37B",
        "description": "",
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Air_Force_Station_Space_Launch_Complex_37",
        "map_url": "https://www.google.com/maps?q=28.5317,-80.56495",
        "latitude": "28.5317",
        "longitude": "-80.56495",
        "location": {
            "id": 12,
            "url": "https://ll.thespacedevs.com/2.2.0/location/12/?format=api",
            "name": "Cape Canaveral SFS, FL, USA",
            "country_code": "USA",
            "description": "Cape Canaveral Space Force Station (CCSFS) is an installation of the United States Space Force's Space Launch Delta 45, located on Cape Canaveral in Brevard County, Florida.",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg",
            "timezone_name": "America/New_York",
            "total_launch_count": 1024,
            "total_landing_count": 64
        },
        "country_code": "USA",
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_38_20200803143515.jpg",
        "total_launch_count": 40,
        "orbital_launch_attempt_count": 40
    },
    "infoURLs": [
        {
            "priority": 10,
            "source": "www.ulalaunch.com",
            "title": "Delta IV Heavy NROL-70",
            "description": "Launch update: The launch of a United Launch Alliance Delta IV Heavy carrying the NROL-70 mission for the National Reconnaissance Office was scrubbed today due to an issue with a liquid pump failure on the gaseous nitrogen pipeline which provides pneumatic pressure to the launch vehicle systems. The...",
            "feature_image": null,
            "url": "https://www.ulalaunch.com/missions/next-launch/delta-iv-heavy-nrol-70",
            "type": {
                "id": 1,
                "name": "Official Page"
            },
            "language": {
                "id": 1,
                "name": "English",
                "code": "en"
            }
        }
    ],
    "vidURLs": [
        {
            "priority": 10,
            "source": "youtube.com",
            "publisher": "United Launch Alliance",
            "title": "April 9 LIVE Broadcast: Delta IV Heavy NROL-70",
            "description": "A United Launch Alliance (ULA) Delta IV Heavy rocket is launching the NROL-70 mission for the National Reconnaissance Office (NRO). Liftoff will occur from S...",
            "feature_image": "https://i.ytimg.com/vi/aTh7dhCYZFE/maxresdefault_live.jpg",
            "url": "https://www.youtube.com/watch?v=aTh7dhCYZFE",
            "type": {
                "id": 1,
                "name": "Official Webcast"
            },
            "language": {
                "id": 1,
                "name": "English",
                "code": "en"
            },
            "start_time": "2024-04-09T16:20:22Z",
            "end_time": "2024-04-09T17:06:29Z"
        }
    ],
    "webcast_live": false,
    "timeline": [
        {
            "type": {
                "id": 9,
                "abbrev": "Ignition",
                "description": "Start of the engine ignition sequence"
            },
            "relative_time": "-PT5S"
        },
        {
            "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": "PT1M18S"
        },
        {
            "type": {
                "id": 11,
                "abbrev": "Max-Q",
                "description": "Maximum dynamic pressure"
            },
            "relative_time": "PT1M20S"
        },
        {
            "type": {
                "id": 99,
                "abbrev": "BECO",
                "description": "Booster Engine Cutoff"
            },
            "relative_time": "PT3M55S"
        },
        {
            "type": {
                "id": 100,
                "abbrev": "Booster Separation",
                "description": "The side boosters are separated from the launcher."
            },
            "relative_time": "PT3M57S"
        },
        {
            "type": {
                "id": 12,
                "abbrev": "MECO",
                "description": "Cut-off of the main engine"
            },
            "relative_time": "PT5M35S"
        },
        {
            "type": {
                "id": 13,
                "abbrev": "Stage 2 Separation",
                "description": "Separation of the second stage from the first"
            },
            "relative_time": "PT5M42S"
        },
        {
            "type": {
                "id": 14,
                "abbrev": "SES-1",
                "description": "First start of the second engine"
            },
            "relative_time": "PT5M55S"
        },
        {
            "type": {
                "id": 15,
                "abbrev": "Fairing Separation",
                "description": "Separation of the payload fairing"
            },
            "relative_time": "PT6M37S"
        }
    ],
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/divh_liftoff_fr_image_20240410045210.jpg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 6657,
    "location_launch_attempt_count": 944,
    "pad_launch_attempt_count": 40,
    "agency_launch_attempt_count": 161,
    "orbital_launch_attempt_count_year": 68,
    "location_launch_attempt_count_year": 17,
    "pad_launch_attempt_count_year": 1,
    "agency_launch_attempt_count_year": 2,
    "pad_turnaround": "P292DT7H35M",
    "mission_patches": [
        {
            "id": 999,
            "name": "NROL-70",
            "priority": 10,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/nrol-70_mission_patch_20240328161206.png",
            "agency": {
                "id": 181,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/181/?format=api",
                "name": "National Reconnaissance Office",
                "type": "Government"
            }
        }
    ],
    "type": "detailed"
}