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/ca3d56b7-2175-48e4-9a6a-2ecc9996d96b/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
  "id": "ca3d56b7-2175-48e4-9a6a-2ecc9996d96b",
  "url": "https://lldev.thespacedevs.com/2.0.0/launch/ca3d56b7-2175-48e4-9a6a-2ecc9996d96b/?format=api",
  "launch_library_id": null,
  "slug": "new-glenn-amazon-leo-ln-01",
  "name": "New Glenn | Amazon Leo (LN-01)",
  "status": {
    "id": 2,
    "name": "TBD"
  },
  "net": "2026-12-31T00:00:00Z",
  "window_end": "2026-12-31T00:00:00Z",
  "window_start": "2026-12-31T00:00:00Z",
  "inhold": false,
  "tbdtime": true,
  "tbddate": true,
  "probability": null,
  "holdreason": "",
  "failreason": "",
  "hashtag": null,
  "launch_service_provider": {
    "id": 141,
    "url": "https://lldev.thespacedevs.com/2.0.0/agencies/141/?format=api",
    "name": "Blue Origin",
    "featured": true,
    "type": "Commercial",
    "country_code": "USA",
    "abbrev": "BO",
    "description": "Blue Origin is an American privately funded aerospace manufacturer and spaceflight services company set up by Amazon.com founder Jeff Bezos with its headquarters in Kent, Washington. The company is developing technologies to enable private human access to space with the goal to dramatically lower costs and increase reliability. Blue Origin currently launches its New Shepard sub-orbital vehicle from its West Texas launch site, they are currently constructing a launch pad for their orbital vehicle New Glenn at Cape Canaveral LC-36.",
    "administrator": "CEO: Jeff Bezos",
    "founding_year": "2000",
    "launchers": "New Shepard | New Glenn",
    "spacecraft": "",
    "launch_library_url": null,
    "total_launch_count": 41,
    "consecutive_successful_launches": 0,
    "successful_launches": 39,
    "failed_launches": 2,
    "pending_launches": 4,
    "consecutive_successful_landings": 12,
    "successful_landings": 38,
    "failed_landings": 3,
    "attempted_landings": 41,
    "info_url": "https://www.blueorigin.com/",
    "wiki_url": "https://en.wikipedia.org/wiki/Blue_Origin",
    "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/blue2520origin_logo_20190207032427.png",
    "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/blue2520origin_image_20190207032427.jpeg",
    "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/blue2520origin_nation_20240222073724.jpg"
  },
  "rocket": {
    "id": 2581,
    "configuration": {
      "id": 138,
      "launch_library_id": 1001,
      "url": "https://lldev.thespacedevs.com/2.0.0/config/launcher/138/?format=api",
      "name": "New Glenn",
      "description": "The New Glenn is a privately funded orbital launch vehicle in development by Blue Origin. New Glenn is described as a 7-meter-diameter (23 ft), two- or three-stage rocket.",
      "family": "New Glenn",
      "full_name": "New Glenn",
      "manufacturer": {
        "id": 141,
        "url": "https://lldev.thespacedevs.com/2.0.0/agencies/141/?format=api",
        "name": "Blue Origin",
        "featured": true,
        "type": "Commercial",
        "country_code": "USA",
        "abbrev": "BO",
        "description": "Blue Origin is an American privately funded aerospace manufacturer and spaceflight services company set up by Amazon.com founder Jeff Bezos with its headquarters in Kent, Washington. The company is developing technologies to enable private human access to space with the goal to dramatically lower costs and increase reliability. Blue Origin currently launches its New Shepard sub-orbital vehicle from its West Texas launch site, they are currently constructing a launch pad for their orbital vehicle New Glenn at Cape Canaveral LC-36.",
        "administrator": "CEO: Jeff Bezos",
        "founding_year": "2000",
        "launchers": "New Shepard | New Glenn",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 41,
        "consecutive_successful_launches": 0,
        "successful_launches": 39,
        "failed_launches": 2,
        "pending_launches": 4,
        "consecutive_successful_landings": 12,
        "successful_landings": 38,
        "failed_landings": 3,
        "attempted_landings": 41,
        "info_url": "https://www.blueorigin.com/",
        "wiki_url": "https://en.wikipedia.org/wiki/Blue_Origin",
        "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/blue2520origin_logo_20190207032427.png",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/blue2520origin_image_20190207032427.jpeg",
        "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/blue2520origin_nation_20240222073724.jpg"
      },
      "program": [],
      "variant": "",
      "alias": "",
      "min_stage": 2,
      "max_stage": 2,
      "length": 98.0,
      "diameter": 7.0,
      "maiden_flight": "2025-01-16",
      "launch_mass": null,
      "leo_capacity": 45000,
      "gto_capacity": 13000,
      "to_thrust": 17126,
      "apogee": null,
      "vehicle_range": null,
      "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/new_glenn_on_lc_image_20240313170026.jpeg",
      "info_url": "https://www.blueorigin.com/new-glenn/",
      "wiki_url": "https://en.wikipedia.org/wiki/New_Glenn",
      "total_launch_count": 3,
      "consecutive_successful_launches": 0,
      "successful_launches": 2,
      "failed_launches": 1,
      "pending_launches": 4
    },
    "launcher_stage": [
      {
        "id": 813,
        "type": "Core",
        "reused": null,
        "launcher_flight_number": null,
        "launcher": {
          "id": 152,
          "url": "https://lldev.thespacedevs.com/2.0.0/launcher/152/?format=api",
          "details": "Booster serial number unknown.",
          "flight_proven": false,
          "serial_number": "Unknown NG",
          "status": "N/A",
          "image_url": null,
          "successful_landings": null,
          "attempted_landings": null,
          "flights": null,
          "last_launch_date": null,
          "first_launch_date": null
        },
        "landing": {
          "id": 1867,
          "attempt": true,
          "success": null,
          "description": "New Glenn booster will land on Jacklyn after its flight.",
          "location": {
            "id": 51,
            "name": "Jacklyn",
            "abbrev": "LPV1",
            "description": "Jacklyn is Blue Origins first floating landing platform for New Glenn.",
            "location": null,
            "successful_landings": 2
          },
          "type": {
            "id": 1,
            "name": "Autonomous Spaceport Drone Ship",
            "abbrev": "ASDS",
            "description": "An autonomous spaceport drone ship (ASDS) is an ocean-going vessel derived from a deck barge, outfitted with station-keeping engines and a large landing platform. Construction of such ships was commissioned by aerospace company SpaceX to allow for recovery of rocket first-stages at sea for high-velocity missions which do not carry enough fuel to return to the launch site after lofting spacecraft onto an orbital trajectory."
          }
        },
        "previous_flight_date": null,
        "turn_around_time_days": null,
        "previous_flight": null
      }
    ],
    "spacecraft_stage": null
  },
  "mission": {
    "id": 6001,
    "launch_library_id": null,
    "name": "Amazon Leo (LN-01)",
    "description": "Amazon Leo, formerly known as Project Kuiper, is a mega constellation of satellites in Low Earth Orbit that will offer broadband internet access, this constellation will be managed by Kuiper Systems LLC, a subsidiary of Amazon. This constellation is planned to be composed of 3,276 satellites. The satellites are projected to be placed in 98 orbital planes in three orbital layers, one at 590 km, 610 km and 630 km altitude.\r\n\r\n48 satellites will be carried on this New Glenn launch.",
    "launch_designator": null,
    "type": "Communications",
    "orbit": {
      "id": 8,
      "name": "Low Earth Orbit",
      "abbrev": "LEO"
    }
  },
  "pad": {
    "id": 121,
    "url": "https://lldev.thespacedevs.com/2.0.0/pad/121/?format=api",
    "agency_id": 161,
    "name": "Launch Complex 36A",
    "info_url": null,
    "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Launch_Complex_36",
    "map_url": "https://www.google.com/maps?q=28.4705556,-80.542194",
    "latitude": "28.4705556",
    "longitude": "-80.542194",
    "location": {
      "id": 12,
      "url": "https://lldev.thespacedevs.com/2.0.0/location/12/?format=api",
      "name": "Cape Canaveral SFS, FL, USA",
      "country_code": "USA",
      "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg",
      "total_launch_count": 1114,
      "total_landing_count": 75
    },
    "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_121_20200803143231.jpg",
    "total_launch_count": 71
  },
  "infoURLs": [],
  "vidURLs": [],
  "webcast_live": false,
  "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/new_glenn_on_lc_image_20240313170026.jpeg",
  "infographic": null,
  "program": [
    {
      "id": 27,
      "url": "https://lldev.thespacedevs.com/2.0.0/program/27/?format=api",
      "name": "Amazon Leo",
      "description": "Amazon Leo is a satellite internet constellation aimed at providing high-speed, low-latency broadband connectivity to underserved and remote areas globally. The project involves deploying a constellation of low Earth orbit (LEO) satellites to create a satellite internet network capable of delivering reliable internet access.",
      "agencies": [
        {
          "id": 1058,
          "url": "https://lldev.thespacedevs.com/2.0.0/agencies/1058/?format=api",
          "name": "Amazon Leo",
          "type": "Private"
        }
      ],
      "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/project2520kui_program_20231228165031.jpeg",
      "start_date": "2023-10-16T18:06:00Z",
      "end_date": null,
      "info_url": "https://en.wikipedia.org/wiki/Kuiper_Systems",
      "wiki_url": "https://aboutamazon.com/what-we-do/devices-services/project-kuiper"
    }
  ],
  "orbital_launch_attempt_count": 7489,
  "location_launch_attempt_count": 1170,
  "pad_launch_attempt_count": 74,
  "agency_launch_attempt_count": 44,
  "orbital_launch_attempt_count_year": 316,
  "location_launch_attempt_count_year": 94,
  "pad_launch_attempt_count_year": 4,
  "agency_launch_attempt_count_year": 5
}