API endpoint that returns all Launch objects or a single launch.

EXAMPLE - /launch// 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'

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.0.0/launch/c0d90c60-4961-470a-a6d7-804b3bf4b012/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
  "id": "c0d90c60-4961-470a-a6d7-804b3bf4b012",
  "url": "https://lldev.thespacedevs.com/2.0.0/launch/c0d90c60-4961-470a-a6d7-804b3bf4b012/?format=api",
  "launch_library_id": null,
  "slug": "starship-integrated-flight-test-3",
  "name": "Starship | Integrated Flight Test 3",
  "status": {
    "id": 3,
    "name": "Success"
  },
  "net": "2024-03-14T13:25:00Z",
  "window_end": "2024-03-14T13:50:00Z",
  "window_start": "2024-03-14T12:00:00Z",
  "inhold": false,
  "tbdtime": false,
  "tbddate": false,
  "probability": 70,
  "holdreason": "",
  "failreason": "",
  "hashtag": null,
  "launch_service_provider": {
    "id": 121,
    "url": "https://lldev.thespacedevs.com/2.0.0/agencies/121/?format=api",
    "name": "SpaceX",
    "featured": true,
    "type": "Commercial",
    "country_code": "USA",
    "abbrev": "SpX",
    "description": "Space Exploration Technologies Corp., known as SpaceX, is an American aerospace manufacturer and space transport services company headquartered in Hawthorne, California. It was founded in 2002 by entrepreneur Elon Musk with the goal of reducing space transportation costs and enabling the colonization of Mars. SpaceX operates from many pads, on the East Coast of the US they operate from SLC-40 at Cape Canaveral Space Force Station and historic LC-39A at Kennedy Space Center. They also operate from SLC-4E at Vandenberg Space Force Base, California, usually for polar launches. Another launch site is being developed at Boca Chica, Texas.",
    "administrator": "CEO: Elon Musk",
    "founding_year": "2002",
    "launchers": "Falcon | Starship",
    "spacecraft": "Dragon",
    "launch_library_url": null,
    "total_launch_count": 745,
    "consecutive_successful_launches": 230,
    "successful_launches": 730,
    "failed_launches": 15,
    "pending_launches": 136,
    "consecutive_successful_landings": 39,
    "successful_landings": 690,
    "failed_landings": 29,
    "attempted_landings": 718,
    "info_url": "https://www.spacex.com/",
    "wiki_url": "https://en.wikipedia.org/wiki/SpaceX",
    "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/spacex_logo_20220826094919.png",
    "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/falcon_9_image_20230807133459.jpeg",
    "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/spacex_social_l_image_20260407054626.jpg"
  },
  "rocket": {
    "id": 8098,
    "configuration": {
      "id": 464,
      "launch_library_id": null,
      "url": "https://lldev.thespacedevs.com/2.0.0/config/launcher/464/?format=api",
      "name": "Starship",
      "description": "First development version of the Starship reusable two-stage super heavy-lift launch vehicle.",
      "family": "Starship",
      "full_name": "Starship V1",
      "manufacturer": {
        "id": 121,
        "url": "https://lldev.thespacedevs.com/2.0.0/agencies/121/?format=api",
        "name": "SpaceX",
        "featured": true,
        "type": "Commercial",
        "country_code": "USA",
        "abbrev": "SpX",
        "description": "Space Exploration Technologies Corp., known as SpaceX, is an American aerospace manufacturer and space transport services company headquartered in Hawthorne, California. It was founded in 2002 by entrepreneur Elon Musk with the goal of reducing space transportation costs and enabling the colonization of Mars. SpaceX operates from many pads, on the East Coast of the US they operate from SLC-40 at Cape Canaveral Space Force Station and historic LC-39A at Kennedy Space Center. They also operate from SLC-4E at Vandenberg Space Force Base, California, usually for polar launches. Another launch site is being developed at Boca Chica, Texas.",
        "administrator": "CEO: Elon Musk",
        "founding_year": "2002",
        "launchers": "Falcon | Starship",
        "spacecraft": "Dragon",
        "launch_library_url": null,
        "total_launch_count": 745,
        "consecutive_successful_launches": 230,
        "successful_launches": 730,
        "failed_launches": 15,
        "pending_launches": 136,
        "consecutive_successful_landings": 39,
        "successful_landings": 690,
        "failed_landings": 29,
        "attempted_landings": 718,
        "info_url": "https://www.spacex.com/",
        "wiki_url": "https://en.wikipedia.org/wiki/SpaceX",
        "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/spacex_logo_20220826094919.png",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/falcon_9_image_20230807133459.jpeg",
        "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/spacex_social_l_image_20260407054626.jpg"
      },
      "program": [
        {
          "id": 1,
          "url": "https://lldev.thespacedevs.com/2.0.0/program/1/?format=api",
          "name": "SpaceX Starship",
          "description": "The SpaceX Starship is a fully reusable super heavy-lift launch vehicle under development by SpaceX since 2012, as a self-funded private spaceflight project.  The second stage of the Starship — is designed as a long-duration cargo and passenger-carrying spacecraft. It is expected to be initially used without any booster stage at all, as part of an extensive development program to prove out launch-and-landing and iterate on a variety of design details, particularly with respect to the vehicle's atmospheric reentry.",
          "agencies": [
            {
              "id": 121,
              "url": "https://lldev.thespacedevs.com/2.0.0/agencies/121/?format=api",
              "name": "SpaceX",
              "type": "Commercial"
            }
          ],
          "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/starship_on_the_image_20250111100520.jpg",
          "start_date": "2019-03-01T05:00:00Z",
          "end_date": null,
          "info_url": "https://www.spacex.com/vehicles/starship/",
          "wiki_url": "https://en.wikipedia.org/wiki/SpaceX_Starship"
        }
      ],
      "variant": "V1",
      "alias": "",
      "min_stage": 2,
      "max_stage": 2,
      "length": 121.3,
      "diameter": 9.0,
      "maiden_flight": "2023-04-20",
      "launch_mass": 5000,
      "leo_capacity": 15000,
      "gto_capacity": null,
      "to_thrust": 73550,
      "apogee": null,
      "vehicle_range": null,
      "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/starship_liftof_image_20240314160301.jpg",
      "info_url": "https://www.spacex.com/vehicles/starship",
      "wiki_url": "https://en.wikipedia.org/wiki/SpaceX_Starship",
      "total_launch_count": 6,
      "consecutive_successful_launches": 4,
      "successful_launches": 4,
      "failed_launches": 2,
      "pending_launches": 0
    },
    "launcher_stage": [
      {
        "id": 472,
        "type": "Core",
        "reused": false,
        "launcher_flight_number": 1,
        "launcher": {
          "id": 137,
          "url": "https://lldev.thespacedevs.com/2.0.0/launcher/137/?format=api",
          "details": "Super Heavy booster used for the third Starship integrated flight test. It was lost to a hard water landing due to multiple Raptor engines failing to reignite.",
          "flight_proven": false,
          "serial_number": "Booster 10",
          "status": "destroyed",
          "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/137_image_20231229222125.jpeg",
          "successful_landings": 0,
          "attempted_landings": 1,
          "flights": 1,
          "last_launch_date": "2024-03-14T13:25:00Z",
          "first_launch_date": "2024-03-14T13:25:00Z"
        },
        "landing": {
          "id": 1275,
          "attempt": true,
          "success": false,
          "description": "Landing burn of Booster 10 failed.",
          "location": {
            "id": 16,
            "name": "Gulf of Mexico",
            "abbrev": "GOM",
            "description": "Gulf of Mexico",
            "location": null,
            "successful_landings": 19
          },
          "type": {
            "id": 3,
            "name": "Ocean",
            "abbrev": "Ocean",
            "description": "No recovery attempt"
          }
        },
        "previous_flight_date": null,
        "turn_around_time_days": null,
        "previous_flight": null
      }
    ],
    "spacecraft_stage": {
      "id": 824,
      "url": "https://lldev.thespacedevs.com/2.0.0/spacecraft/flight/824/?format=api",
      "mission_end": "2024-03-14T14:14:35Z",
      "destination": "Indian Ocean",
      "launch_crew": [],
      "onboard_crew": [],
      "landing_crew": [],
      "spacecraft": {
        "id": 575,
        "url": "https://lldev.thespacedevs.com/2.0.0/spacecraft/575/?format=api",
        "name": "Ship 28",
        "serial_number": "S28",
        "status": {
          "id": 3,
          "name": "Destroyed"
        },
        "description": "Ship 28 (S28) was lost during atmospheric re-entry at the end of the third integrated flight test.",
        "spacecraft_config": {
          "id": 26,
          "url": "https://lldev.thespacedevs.com/2.0.0/config/spacecraft/26/?format=api",
          "name": "Starship V1",
          "type": {
            "id": 6,
            "name": "Reuseable Upper Stage"
          },
          "agency": {
            "id": 121,
            "url": "https://lldev.thespacedevs.com/2.0.0/agencies/121/?format=api",
            "name": "SpaceX",
            "featured": true,
            "type": "Commercial",
            "country_code": "USA",
            "abbrev": "SpX",
            "description": "Space Exploration Technologies Corp., known as SpaceX, is an American aerospace manufacturer and space transport services company headquartered in Hawthorne, California. It was founded in 2002 by entrepreneur Elon Musk with the goal of reducing space transportation costs and enabling the colonization of Mars. SpaceX operates from many pads, on the East Coast of the US they operate from SLC-40 at Cape Canaveral Space Force Station and historic LC-39A at Kennedy Space Center. They also operate from SLC-4E at Vandenberg Space Force Base, California, usually for polar launches. Another launch site is being developed at Boca Chica, Texas.",
            "administrator": "CEO: Elon Musk",
            "founding_year": "2002",
            "launchers": "Falcon | Starship",
            "spacecraft": "Dragon",
            "parent": null,
            "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/falcon_9_image_20230807133459.jpeg"
          },
          "in_use": false,
          "capability": "More than 50 tons to Earth orbit (theoretical)",
          "history": "The Starship second stage was testing during a number of low and high altitude suborbital flights before the first orbital launch attempt.",
          "details": "First-generation second stage of the two-stage Starship super heavy-lift launch vehicle.",
          "maiden_flight": "2023-04-20",
          "height": 50.3,
          "diameter": 9.0,
          "human_rated": false,
          "crew_capacity": 0,
          "payload_capacity": null,
          "flight_life": "Never used for orbital flights.",
          "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/starship_image_20231116184708.jpeg",
          "nation_url": null,
          "wiki_link": "",
          "info_link": "https://www.spacex.com/vehicles/starship"
        }
      },
      "docking_events": []
    }
  },
  "mission": {
    "id": 6655,
    "launch_library_id": null,
    "name": "Integrated Flight Test 3",
    "description": "Third test flight of the two-stage Starship launch vehicle.",
    "launch_designator": null,
    "type": "Test Flight",
    "orbit": {
      "id": 15,
      "name": "Suborbital",
      "abbrev": "Sub"
    }
  },
  "pad": {
    "id": 188,
    "url": "https://lldev.thespacedevs.com/2.0.0/pad/188/?format=api",
    "agency_id": 121,
    "name": "Orbital Launch Pad 1",
    "info_url": null,
    "wiki_url": "https://en.wikipedia.org/wiki/SpaceX_Starbase#Launch_site_(Orbital_Launch_Mount_(Pad_1_and_2))",
    "map_url": "https://www.google.com/maps?q=25.9962,-97.154423",
    "latitude": "25.9962",
    "longitude": "-97.154423",
    "location": {
      "id": 143,
      "url": "https://lldev.thespacedevs.com/2.0.0/location/143/?format=api",
      "name": "SpaceX Starbase, TX, USA",
      "country_code": "USA",
      "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_143_20200803142438.jpg",
      "total_launch_count": 23,
      "total_landing_count": 13
    },
    "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_orbital_launch_mount_a_20210514061342.jpg",
    "total_launch_count": 11
  },
  "infoURLs": [
    {
      "priority": 10,
      "title": "SpaceX",
      "description": "SpaceX designs, manufactures and launches advanced rockets and spacecraft. The company was founded in 2002 to revolutionize space technology, with the ultimate goal of enabling people to live on other planets.",
      "feature_image": null,
      "url": "https://www.spacex.com/launches/mission/?missionId=starship-flight-3"
    }
  ],
  "vidURLs": [
    {
      "priority": 9,
      "title": "SpaceX Integrated Flight Test 3",
      "description": "On Thursday March 14, 2024, SpaceX launched the Integrated Flight Test 3 mission with a Starship from Orbital Launch Mount A at SpaceX Starbase, TX, USA.Desc...",
      "feature_image": "https://i.ytimg.com/vi/hcTxmw_yZ_c/maxresdefault.jpg",
      "url": "https://www.youtube.com/watch?v=hcTxmw_yZ_c"
    },
    {
      "priority": 10,
      "title": "Starship's Third Flight Test",
      "description": "Livestream on X",
      "feature_image": "https://pbs.twimg.com/media/GH6sIAdaEAA4Oc_.jpg",
      "url": "https://twitter.com/i/broadcasts/1LyxBnOvzvOxN"
    },
    {
      "priority": 11,
      "title": "SpaceX Launches Third Starship Flight Test",
      "description": "SpaceX is targeting Thursday for the third flight of Starship. The license from the FAA was acquired. The flight will feature several upgrades to Booster and...",
      "feature_image": "https://i.ytimg.com/vi/RrxCYzixV3s/maxresdefault_live.jpg",
      "url": "https://www.youtube.com/watch?v=RrxCYzixV3s"
    },
    {
      "priority": 12,
      "title": "Watch live: SpaceX launches Starship/Super Heavy Booster on third test flight",
      "description": "Watch live as a Super Heavy booster and Starship launch on the third integrated test flight of SpaceX's massive new rocket (IFT-3). The plan is for the Starship to achieve near-orbital velocity on a m...",
      "feature_image": "https://i.ytimg.com/vi/EfnkZFtHPmM/maxresdefault.jpg",
      "url": "https://www.youtube.com/watch?v=EfnkZFtHPmM"
    },
    {
      "priority": 13,
      "title": "[4K] Watch SpaceX launch Starship, LIVE up close and personal!",
      "description": "[TIME SUBJECT TO CHANGE] This is the third fully integrated full stack test flight of Starship and the mighty Super Heavy booster, the largest and most powerful rocket to ever fly. It produces over tw...",
      "feature_image": "https://i.ytimg.com/vi/ixZpBOxMopc/maxresdefault.jpg",
      "url": "https://www.youtube.com/watch?v=ixZpBOxMopc"
    }
  ],
  "webcast_live": false,
  "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/starship_liftof_image_20240314160301.jpg",
  "infographic": null,
  "program": [
    {
      "id": 1,
      "url": "https://lldev.thespacedevs.com/2.0.0/program/1/?format=api",
      "name": "SpaceX Starship",
      "description": "The SpaceX Starship is a fully reusable super heavy-lift launch vehicle under development by SpaceX since 2012, as a self-funded private spaceflight project.  The second stage of the Starship — is designed as a long-duration cargo and passenger-carrying spacecraft. It is expected to be initially used without any booster stage at all, as part of an extensive development program to prove out launch-and-landing and iterate on a variety of design details, particularly with respect to the vehicle's atmospheric reentry.",
      "agencies": [
        {
          "id": 121,
          "url": "https://lldev.thespacedevs.com/2.0.0/agencies/121/?format=api",
          "name": "SpaceX",
          "type": "Commercial"
        }
      ],
      "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/starship_on_the_image_20250111100520.jpg",
      "start_date": "2019-03-01T05:00:00Z",
      "end_date": null,
      "info_url": "https://www.spacex.com/vehicles/starship/",
      "wiki_url": "https://en.wikipedia.org/wiki/SpaceX_Starship"
    }
  ],
  "orbital_launch_attempt_count": null,
  "location_launch_attempt_count": 12,
  "pad_launch_attempt_count": 3,
  "agency_launch_attempt_count": 336,
  "orbital_launch_attempt_count_year": null,
  "location_launch_attempt_count_year": 1,
  "pad_launch_attempt_count_year": 1,
  "agency_launch_attempt_count_year": 25
}