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/b72e2e92-d909-487f-b498-0fe1d461b821/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
  "id": "b72e2e92-d909-487f-b498-0fe1d461b821",
  "url": "https://lldev.thespacedevs.com/2.0.0/launch/b72e2e92-d909-487f-b498-0fe1d461b821/?format=api",
  "launch_library_id": null,
  "slug": "hanbit-tlv-sisnav",
  "name": "HANBIT-TLV | SISNAV",
  "status": {
    "id": 3,
    "name": "Success"
  },
  "net": "2023-03-19T17:52:00Z",
  "window_end": "2023-03-19T17:52:00Z",
  "window_start": "2023-03-19T17:52:00Z",
  "inhold": false,
  "tbdtime": false,
  "tbddate": false,
  "probability": null,
  "holdreason": "",
  "failreason": "",
  "hashtag": null,
  "launch_service_provider": {
    "id": 1098,
    "url": "https://lldev.thespacedevs.com/2.0.0/agencies/1098/?format=api",
    "name": "Innospace",
    "featured": false,
    "type": "Private",
    "country_code": "KOR",
    "abbrev": "IS",
    "description": "Innospace is a South Korean startup company specializing in developing hybrid space rocket.",
    "administrator": "CEO: Kim Soo-jong",
    "founding_year": "2017",
    "launchers": "HANBIT",
    "spacecraft": "",
    "launch_library_url": null,
    "total_launch_count": 2,
    "consecutive_successful_launches": 0,
    "successful_launches": 1,
    "failed_launches": 1,
    "pending_launches": 1,
    "consecutive_successful_landings": 0,
    "successful_landings": 0,
    "failed_landings": 0,
    "attempted_landings": 0,
    "info_url": "https://www.innospc.com/main",
    "wiki_url": "https://en.wikipedia.org/wiki/Innospace",
    "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/innospace_socia_image_20251021112531.png",
    "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/hanbit-tlv_laun_image_20251021112914.jpg",
    "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/innospace_socia_image_20251021112531.png"
  },
  "rocket": {
    "id": 8776,
    "configuration": {
      "id": 529,
      "launch_library_id": null,
      "url": "https://lldev.thespacedevs.com/2.0.0/config/launcher/529/?format=api",
      "name": "HANBIT-TLV",
      "description": "Suborbital engine verification test launch vehicle manufactured by Innospace.",
      "family": "HANBIT",
      "full_name": "HANBIT-TLV",
      "manufacturer": {
        "id": 1098,
        "url": "https://lldev.thespacedevs.com/2.0.0/agencies/1098/?format=api",
        "name": "Innospace",
        "featured": false,
        "type": "Private",
        "country_code": "KOR",
        "abbrev": "IS",
        "description": "Innospace is a South Korean startup company specializing in developing hybrid space rocket.",
        "administrator": "CEO: Kim Soo-jong",
        "founding_year": "2017",
        "launchers": "HANBIT",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 2,
        "consecutive_successful_launches": 0,
        "successful_launches": 1,
        "failed_launches": 1,
        "pending_launches": 1,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "https://www.innospc.com/main",
        "wiki_url": "https://en.wikipedia.org/wiki/Innospace",
        "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/innospace_socia_image_20251021112531.png",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/hanbit-tlv_laun_image_20251021112914.jpg",
        "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/innospace_socia_image_20251021112531.png"
      },
      "program": [],
      "variant": "TLV",
      "alias": "",
      "min_stage": 1,
      "max_stage": 1,
      "length": 16.3,
      "diameter": 1.0,
      "maiden_flight": "2023-03-19",
      "launch_mass": 9,
      "leo_capacity": null,
      "gto_capacity": null,
      "to_thrust": 150,
      "apogee": 80,
      "vehicle_range": null,
      "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/hanbit-tlv_laun_image_20251021112914.jpg",
      "info_url": null,
      "wiki_url": "https://en.wikipedia.org/wiki/Innospace_HANBIT-TLV",
      "total_launch_count": 1,
      "consecutive_successful_launches": 1,
      "successful_launches": 1,
      "failed_launches": 0,
      "pending_launches": 0
    },
    "launcher_stage": [],
    "spacecraft_stage": null
  },
  "mission": {
    "id": 7367,
    "launch_library_id": null,
    "name": "SISNAV",
    "description": "Engine verification test flight, carrying the SISNAV payload, an inertial navigation system of the Brazilian Air Force.",
    "launch_designator": null,
    "type": "Test Flight",
    "orbit": {
      "id": 15,
      "name": "Suborbital",
      "abbrev": "Sub"
    }
  },
  "pad": {
    "id": 240,
    "url": "https://lldev.thespacedevs.com/2.0.0/pad/240/?format=api",
    "agency_id": 1098,
    "name": "HANBIT Pad",
    "info_url": null,
    "wiki_url": "https://en.wikipedia.org/wiki/Alc%C3%A2ntara_Space_Center",
    "map_url": "https://www.google.com/maps?q=-2.31698,-44.36873",
    "latitude": "-2.31698",
    "longitude": "-44.36873",
    "location": {
      "id": 150,
      "url": "https://lldev.thespacedevs.com/2.0.0/location/150/?format=api",
      "name": "Alcântara Space Center, Federative Republic of Brazil",
      "country_code": "BRA",
      "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_150_20200803142405.jpg",
      "total_launch_count": 4,
      "total_landing_count": 0
    },
    "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_hanbit_pad_20251021114902.jpg",
    "total_launch_count": 2
  },
  "infoURLs": [],
  "vidURLs": [
    {
      "priority": 10,
      "title": "HANBIT-TLV Lift-off! – INNOSPACE l 이노스페이스",
      "description": "HANBIT-TLV which carried onboard the payload SISNAV developed by DCTA successfully launched from the Alcântara Space Center in Brazil, March 19 at 2:52 p.m. BRT.\n\nToday we made historical moment.\n\nFol...",
      "feature_image": "https://i.ytimg.com/vi/9mpieVv9vUQ/maxresdefault.jpg",
      "url": "https://www.youtube.com/watch?v=9mpieVv9vUQ"
    }
  ],
  "webcast_live": false,
  "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/hanbit-tlv_laun_image_20251021112914.jpg",
  "infographic": null,
  "program": [],
  "orbital_launch_attempt_count": null,
  "location_launch_attempt_count": 3,
  "pad_launch_attempt_count": 1,
  "agency_launch_attempt_count": 1,
  "orbital_launch_attempt_count_year": null,
  "location_launch_attempt_count_year": 1,
  "pad_launch_attempt_count_year": 1,
  "agency_launch_attempt_count_year": 1
}