GET

Launch Instance

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/69d0b52a-1dd5-4a15-adc5-468e920a9c97/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
  "id": "69d0b52a-1dd5-4a15-adc5-468e920a9c97",
  "url": "https://ll.thespacedevs.com/2.2.0/launch/69d0b52a-1dd5-4a15-adc5-468e920a9c97/?format=api",
  "slug": "minotaur-iv-haps-stp-s-26",
  "flightclub_url": null,
  "r_spacex_api_id": null,
  "name": "Minotaur IV HAPS | STP S-26",
  "status": {
    "id": 3,
    "name": "Launch Successful",
    "abbrev": "Success",
    "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)."
  },
  "last_updated": "2023-06-14T03:54:51Z",
  "updates": [],
  "net": "2010-11-20T01:25:00Z",
  "net_precision": null,
  "window_end": "2010-11-20T01:25:00Z",
  "window_start": "2010-11-20T01:25:00Z",
  "probability": null,
  "weather_concerns": null,
  "holdreason": "",
  "failreason": null,
  "hashtag": null,
  "launch_service_provider": {
    "id": 100,
    "url": "https://ll.thespacedevs.com/2.2.0/agencies/100/?format=api",
    "name": "Orbital Sciences Corporation",
    "featured": false,
    "type": "Commercial",
    "country_code": "USA",
    "abbrev": "OSC",
    "description": "",
    "administrator": null,
    "founding_year": null,
    "launchers": "",
    "spacecraft": "",
    "launch_library_url": null,
    "total_launch_count": 72,
    "consecutive_successful_launches": 0,
    "successful_launches": 65,
    "failed_launches": 7,
    "pending_launches": 0,
    "consecutive_successful_landings": 0,
    "successful_landings": 0,
    "failed_landings": 0,
    "attempted_landings": 0,
    "info_url": "https://www.orbital.com/",
    "wiki_url": "https://en.wikipedia.org/wiki/Orbital_Sciences_Corporation",
    "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/orbital_science_image_20251120065555.png",
    "image_url": null,
    "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/orbital_icon_image_20251120065816.png"
  },
  "rocket": {
    "id": 1497,
    "configuration": {
      "id": 108,
      "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/108/?format=api",
      "name": "Minotaur IV",
      "active": true,
      "reusable": false,
      "description": "The Minotaur IV HAPS launch system is derived from the Peacekeeper ICBM. The first three stages are taken directly from decommissioned Peacekeeper missiles. A fourth stage, the Orion-38, is taken from the Pegasus family of air-launched rockets. A fifth stage, consisting of a hydrazine-powered motor called HAPS, increases orbital insertion accuracy and allows additional orbital maneuvering.",
      "family": "Minotaur",
      "full_name": "Minotaur IV HAPS",
      "manufacturer": {
        "id": 100,
        "url": "https://ll.thespacedevs.com/2.2.0/agencies/100/?format=api",
        "name": "Orbital Sciences Corporation",
        "featured": false,
        "type": "Commercial",
        "country_code": "USA",
        "abbrev": "OSC",
        "description": "",
        "administrator": null,
        "founding_year": null,
        "launchers": "",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 72,
        "consecutive_successful_launches": 0,
        "successful_launches": 65,
        "failed_launches": 7,
        "pending_launches": 0,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "https://www.orbital.com/",
        "wiki_url": "https://en.wikipedia.org/wiki/Orbital_Sciences_Corporation",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/orbital_science_image_20251120065555.png",
        "image_url": null,
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/orbital_icon_image_20251120065816.png"
      },
      "program": [],
      "variant": "HAPS",
      "alias": "Peacekeeper SLV",
      "min_stage": 5,
      "max_stage": 5,
      "length": 23.9,
      "diameter": 2.35,
      "maiden_flight": "2010-11-20",
      "launch_cost": null,
      "launch_mass": 86,
      "leo_capacity": 1750,
      "gto_capacity": 0,
      "to_thrust": 2200,
      "apogee": 500,
      "vehicle_range": null,
      "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/minotaur_iv_lau_image_20240307170209.jpeg",
      "info_url": null,
      "wiki_url": "https://en.wikipedia.org/wiki/Minotaur_IV",
      "total_launch_count": 1,
      "consecutive_successful_launches": 1,
      "successful_launches": 1,
      "failed_launches": 0,
      "pending_launches": 0,
      "attempted_landings": 0,
      "successful_landings": 0,
      "failed_landings": 0,
      "consecutive_successful_landings": 0
    },
    "launcher_stage": [],
    "spacecraft_stage": null
  },
  "mission": {
    "id": 408,
    "name": "STP S-26",
    "description": "The third Minotaur IV launch, which was also known as STP-S26, deployed eight payloads (STPSat-2, RAX, O/OREOS, FASTSAT, NanoSail-D2, FalconSat-5, Sara-Lily (FASTRAC 1), Emma (FASTRAC 2)). STP-S26 was intended to extend previous standard interface development efforts, implementing a number of capabilities aimed at enabling responsive access to space for small experimental satellites and payloads.",
    "launch_designator": null,
    "type": "Dedicated Rideshare",
    "orbit": {
      "id": 8,
      "name": "Low Earth Orbit",
      "abbrev": "LEO"
    },
    "agencies": [],
    "info_urls": [],
    "vid_urls": []
  },
  "pad": {
    "id": 57,
    "url": "https://ll.thespacedevs.com/2.2.0/pad/57/?format=api",
    "agency_id": null,
    "name": "Launch Pad 1",
    "description": null,
    "info_url": null,
    "wiki_url": "https://en.wikipedia.org/wiki/Pacific_Spaceport_Complex_%E2%80%93_Alaska",
    "map_url": "https://www.google.com/maps?q=57.435833,-152.337778",
    "latitude": "57.435833",
    "longitude": "-152.337778",
    "location": {
      "id": 25,
      "url": "https://ll.thespacedevs.com/2.2.0/location/25/?format=api",
      "name": "Pacific Spaceport Complex, Alaska, USA",
      "country_code": "USA",
      "description": "The Pacific Spaceport Complex – Alaska (PSCA), formerly known as the Kodiak Launch Complex (KLC), is a dual-use commercial and military spaceport for sub-orbital and orbital launch vehicles. The facility is owned and operated by the Alaska Aerospace Corporation, a corporation owned by the Government of Alaska, and is located on Kodiak Island in Alaska.",
      "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_25_20200803142500.jpg",
      "timezone_name": "America/Anchorage",
      "total_launch_count": 9,
      "total_landing_count": 0
    },
    "country_code": "USA",
    "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_57_20200803143509.jpg",
    "total_launch_count": 3,
    "orbital_launch_attempt_count": 3
  },
  "infoURLs": [
    {
      "priority": 0,
      "source": null,
      "title": "Orbital Minotaur IV launches with multiple satellites",
      "description": "Orbital Sciences Corporation used their Minotaur IV launch vehicle to loft eight satellites for the United States Government and university research programmes on Friday night. The mission, designated STP S-26, launched from the Kodiak Launch Complex in Alaska one minute into a 90-minute window, wit...",
      "feature_image": null,
      "url": "https://www.nasaspaceflight.com/2010/11/live-minotaur-launch-multiple-satellites/",
      "type": null,
      "language": null
    }
  ],
  "vidURLs": [
    {
      "priority": 0,
      "source": "youtube.com",
      "publisher": "Matthew Travis",
      "title": "Minotaur 4 rocket launches FastSat, NanoSail-D (7 satellites total) from Kodiak, Alaska",
      "description": "NASA's Fast, Affordable, Science and Technology Satellite, or FASTSAT, has launched from the Kodiak Launch Complex on Kodiak Island, Alaska, and is awaiting separation from the main launch vehicle. Ap...",
      "feature_image": "https://i.ytimg.com/vi/5gS4n5vz9Tw/hqdefault.jpg",
      "url": "https://www.youtube.com/watch?v=5gS4n5vz9Tw",
      "type": {
        "id": 6,
        "name": "Recap"
      },
      "language": {
        "id": 1,
        "name": "English",
        "code": "en"
      },
      "start_time": "2010-11-20T04:21:19Z",
      "end_time": "2010-11-20T04:25:25Z"
    }
  ],
  "webcast_live": false,
  "timeline": [],
  "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/minotaur_iv_lau_image_20240307170209.jpeg",
  "infographic": null,
  "program": [],
  "orbital_launch_attempt_count": 5096,
  "location_launch_attempt_count": 2,
  "pad_launch_attempt_count": 2,
  "agency_launch_attempt_count": 59,
  "orbital_launch_attempt_count_year": 64,
  "location_launch_attempt_count_year": 1,
  "pad_launch_attempt_count_year": 1,
  "agency_launch_attempt_count_year": 2,
  "pad_turnaround": "P3337DT22H45M",
  "mission_patches": [],
  "type": "detailed"
}