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/181b52ee-1b07-468a-8cab-b461fc8cd7db/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
  "id": "181b52ee-1b07-468a-8cab-b461fc8cd7db",
  "url": "https://ll.thespacedevs.com/2.2.0/launch/181b52ee-1b07-468a-8cab-b461fc8cd7db/?format=api",
  "slug": "hyperbola-1-unknown",
  "flightclub_url": null,
  "r_spacex_api_id": null,
  "name": "Hyperbola-1 | Unknown",
  "status": {
    "id": 4,
    "name": "Launch Failure",
    "abbrev": "Failure",
    "description": "Either the launch vehicle did not reach orbit, or the payload(s) failed to separate."
  },
  "last_updated": "2023-07-08T08:41:03Z",
  "updates": [
    {
      "id": 245,
      "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
      "comment": "Launch failure",
      "info_url": "https://m.weibo.cn/detail/4599832902116617",
      "created_by": "Nosu",
      "created_on": "2021-02-01T08:57:53Z"
    },
    {
      "id": 244,
      "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
      "comment": "Added launch.",
      "info_url": "https://twitter.com/Nextlaunch/status/1356110509171486721?s=19",
      "created_by": "Cosmic_Penguin",
      "created_on": "2021-02-01T05:36:36Z"
    }
  ],
  "net": "2021-02-01T08:15:00Z",
  "net_precision": null,
  "window_end": "2021-02-01T09:30:00Z",
  "window_start": "2021-02-01T08:00:00Z",
  "probability": null,
  "weather_concerns": null,
  "holdreason": "",
  "failreason": "",
  "hashtag": null,
  "launch_service_provider": {
    "id": 274,
    "url": "https://ll.thespacedevs.com/2.2.0/agencies/274/?format=api",
    "name": "i-Space",
    "featured": false,
    "type": "Commercial",
    "country_code": "CHN",
    "abbrev": "i-Space",
    "description": "i-Space is a Chinese private space launch company based in Beijing and founded in October 2016.",
    "administrator": null,
    "founding_year": "2016",
    "launchers": "Hyperbola-1",
    "spacecraft": "",
    "launch_library_url": null,
    "total_launch_count": 8,
    "consecutive_successful_launches": 1,
    "successful_launches": 4,
    "failed_launches": 4,
    "pending_launches": 1,
    "consecutive_successful_landings": 0,
    "successful_landings": 0,
    "failed_landings": 0,
    "attempted_landings": 0,
    "info_url": "https://www.i-space.com.cn/",
    "wiki_url": "https://en.wikipedia.org/wiki/I-Space_(Chinese_company)",
    "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ispace_logo_20231217083222.png",
    "image_url": null,
    "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ispace_nation_20231217083130.png"
  },
  "rocket": {
    "id": 2824,
    "configuration": {
      "id": 193,
      "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/193/?format=api",
      "name": "Hyperbola-1",
      "active": true,
      "reusable": false,
      "description": "i-Space's first orbital rocket.",
      "family": "",
      "full_name": "Hyperbola-1",
      "manufacturer": {
        "id": 274,
        "url": "https://ll.thespacedevs.com/2.2.0/agencies/274/?format=api",
        "name": "i-Space",
        "featured": false,
        "type": "Commercial",
        "country_code": "CHN",
        "abbrev": "i-Space",
        "description": "i-Space is a Chinese private space launch company based in Beijing and founded in October 2016.",
        "administrator": null,
        "founding_year": "2016",
        "launchers": "Hyperbola-1",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 8,
        "consecutive_successful_launches": 1,
        "successful_launches": 4,
        "failed_launches": 4,
        "pending_launches": 1,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "https://www.i-space.com.cn/",
        "wiki_url": "https://en.wikipedia.org/wiki/I-Space_(Chinese_company)",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ispace_logo_20231217083222.png",
        "image_url": null,
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ispace_nation_20231217083130.png"
      },
      "program": [],
      "variant": "1",
      "alias": "",
      "min_stage": 4,
      "max_stage": 4,
      "length": 38.0,
      "diameter": 2.5,
      "maiden_flight": "2019-07-25",
      "launch_cost": null,
      "launch_mass": null,
      "leo_capacity": 300,
      "gto_capacity": null,
      "to_thrust": null,
      "apogee": null,
      "vehicle_range": null,
      "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/hyperbola-1_in__image_20240711064715.jpeg",
      "info_url": "https://space.skyrocket.de/doc_lau/shian-quxian-1.htm",
      "wiki_url": "https://en.wikipedia.org/wiki/I-Space_(Chinese_company)",
      "total_launch_count": 8,
      "consecutive_successful_launches": 1,
      "successful_launches": 4,
      "failed_launches": 4,
      "pending_launches": 0,
      "attempted_landings": 0,
      "successful_landings": 0,
      "failed_landings": 0,
      "consecutive_successful_landings": 0
    },
    "launcher_stage": [],
    "spacecraft_stage": null
  },
  "mission": null,
  "pad": {
    "id": 21,
    "url": "https://ll.thespacedevs.com/2.2.0/pad/21/?format=api",
    "agency_id": null,
    "name": "Launch Area 95A",
    "description": "",
    "info_url": null,
    "wiki_url": "https://en.wikipedia.org/wiki/Jiuquan_Satellite_Launch_Center",
    "map_url": "https://www.google.com/maps?q=40.969117,100.343333",
    "latitude": "40.969117",
    "longitude": "100.343333",
    "location": {
      "id": 17,
      "url": "https://ll.thespacedevs.com/2.2.0/location/17/?format=api",
      "name": "Jiuquan Satellite Launch Center, People's Republic of China",
      "country_code": "CHN",
      "description": "Jiuquan Satellite Launch Center is a Chinese spaceport located between the Ejin, Alxa, Inner Mongolia and Hangtian Town, Jinta County, Jiuquan, Gansu Province. It is part of the Dongfeng Aerospace City (Base 10).",
      "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_17_20200803142429.jpg",
      "timezone_name": "Asia/Shanghai",
      "total_launch_count": 286,
      "total_landing_count": 2
    },
    "country_code": "CHN",
    "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_21_20200803143253.jpg",
    "total_launch_count": 66,
    "orbital_launch_attempt_count": 66
  },
  "infoURLs": [],
  "vidURLs": [],
  "webcast_live": false,
  "timeline": [],
  "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/hyperbola-1_in__image_20240711064715.jpeg",
  "infographic": null,
  "program": [],
  "orbital_launch_attempt_count": 6045,
  "location_launch_attempt_count": 137,
  "pad_launch_attempt_count": 22,
  "agency_launch_attempt_count": 2,
  "orbital_launch_attempt_count_year": 8,
  "location_launch_attempt_count_year": 2,
  "pad_launch_attempt_count_year": 1,
  "agency_launch_attempt_count_year": 1,
  "pad_turnaround": "P86DT1H3M",
  "mission_patches": [],
  "type": "detailed"
}