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/f62556c2-41e5-4746-b0a1-5cd751b9ec96/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
  "id": "f62556c2-41e5-4746-b0a1-5cd751b9ec96",
  "url": "https://ll.thespacedevs.com/2.2.0/launch/f62556c2-41e5-4746-b0a1-5cd751b9ec96/?format=api",
  "slug": "zhuque-2-flight-3",
  "flightclub_url": null,
  "r_spacex_api_id": null,
  "name": "Zhuque-2 | Flight 3",
  "status": {
    "id": 3,
    "name": "Launch Successful",
    "abbrev": "Success",
    "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)."
  },
  "last_updated": "2024-06-15T14:35:52Z",
  "updates": [
    {
      "id": 5910,
      "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
      "comment": "Launch success.",
      "info_url": "https://m.weibo.cn/detail/4976947610258357",
      "created_by": "Cosmic_Penguin",
      "created_on": "2023-12-09T00:14:39Z"
    },
    {
      "id": 5881,
      "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
      "comment": "Delayed to December 8 UTC per new NOTAMs.",
      "info_url": "https://forum.nasaspaceflight.com/index.php?topic=57867.msg2547070#msg2547070",
      "created_by": "Cosmic_Penguin",
      "created_on": "2023-12-06T09:57:59Z"
    },
    {
      "id": 5862,
      "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
      "comment": "Go for launch per NOTAMs.",
      "info_url": "https://forum.nasaspaceflight.com/index.php?topic=57867.msg2546380#msg2546380",
      "created_by": "Cosmic_Penguin",
      "created_on": "2023-12-04T03:32:55Z"
    },
    {
      "id": 5773,
      "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
      "comment": "NET December 6 UTC.",
      "info_url": "https://twitter.com/raz_liu/status/1728365645014954369",
      "created_by": "Cosmic_Penguin",
      "created_on": "2023-11-25T12:16:23Z"
    },
    {
      "id": 5746,
      "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
      "comment": "Added launch.",
      "info_url": "https://twitter.com/raz_liu/status/1727181727133778268",
      "created_by": "Cosmic_Penguin",
      "created_on": "2023-11-22T04:57:15Z"
    }
  ],
  "net": "2023-12-08T23:39:03Z",
  "net_precision": {
    "id": 0,
    "name": "Second",
    "abbrev": "SEC",
    "description": "The T-0 is accurate to the second."
  },
  "window_end": "2023-12-09T00:53:00Z",
  "window_start": "2023-12-08T23:31:00Z",
  "probability": null,
  "weather_concerns": null,
  "holdreason": "",
  "failreason": "",
  "hashtag": null,
  "launch_service_provider": {
    "id": 259,
    "url": "https://ll.thespacedevs.com/2.2.0/agencies/259/?format=api",
    "name": "LandSpace",
    "featured": false,
    "type": "Commercial",
    "country_code": "CHN",
    "abbrev": "LS",
    "description": "LandSpace is a Chinese private space launch company based in Beijing. It was founded in 2015 by Tsinghua University alumni Zhang Changwu.",
    "administrator": "Founder: Zhang Changwu",
    "founding_year": "2015",
    "launchers": "",
    "spacecraft": "",
    "launch_library_url": null,
    "total_launch_count": 11,
    "consecutive_successful_launches": 4,
    "successful_launches": 8,
    "failed_launches": 3,
    "pending_launches": 0,
    "consecutive_successful_landings": 1,
    "successful_landings": 1,
    "failed_landings": 1,
    "attempted_landings": 2,
    "info_url": null,
    "wiki_url": "https://en.wikipedia.org/wiki/LandSpace",
    "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/landspace_logo_20220822100731.png",
    "image_url": null,
    "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/landspace_nation_20230702184353.png"
  },
  "rocket": {
    "id": 8099,
    "configuration": {
      "id": 199,
      "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/199/?format=api",
      "name": "Zhuque-2",
      "active": false,
      "reusable": false,
      "description": "Zhuque-2 is a medium-sized rocket powered by liquid oxygen and methane capable of lifting 6,000 kg of payload into a 200 km low Earth orbit, or 4,000 kg of payload into a 500 km Sun-synchronous orbit.",
      "family": "Zhuque",
      "full_name": "Zhuque-2",
      "manufacturer": {
        "id": 259,
        "url": "https://ll.thespacedevs.com/2.2.0/agencies/259/?format=api",
        "name": "LandSpace",
        "featured": false,
        "type": "Commercial",
        "country_code": "CHN",
        "abbrev": "LS",
        "description": "LandSpace is a Chinese private space launch company based in Beijing. It was founded in 2015 by Tsinghua University alumni Zhang Changwu.",
        "administrator": "Founder: Zhang Changwu",
        "founding_year": "2015",
        "launchers": "",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 11,
        "consecutive_successful_launches": 4,
        "successful_launches": 8,
        "failed_launches": 3,
        "pending_launches": 0,
        "consecutive_successful_landings": 1,
        "successful_landings": 1,
        "failed_landings": 1,
        "attempted_landings": 2,
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/LandSpace",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/landspace_logo_20220822100731.png",
        "image_url": null,
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/landspace_nation_20230702184353.png"
      },
      "program": [],
      "variant": "",
      "alias": "",
      "min_stage": 2,
      "max_stage": 2,
      "length": 49.5,
      "diameter": 3.35,
      "maiden_flight": "2022-12-14",
      "launch_cost": null,
      "launch_mass": 229,
      "leo_capacity": 4000,
      "gto_capacity": null,
      "to_thrust": 2680,
      "apogee": null,
      "vehicle_range": null,
      "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/zhuque-2_image_20230802052429.jpeg",
      "info_url": "https://www.landspace.com/en/product.html",
      "wiki_url": "https://en.wikipedia.org/wiki/Zhuque-2",
      "total_launch_count": 3,
      "consecutive_successful_launches": 2,
      "successful_launches": 2,
      "failed_launches": 1,
      "pending_launches": 0,
      "attempted_landings": 0,
      "successful_landings": 0,
      "failed_landings": 0,
      "consecutive_successful_landings": 0
    },
    "launcher_stage": [],
    "spacecraft_stage": null
  },
  "mission": {
    "id": 6656,
    "name": "Flight 3",
    "description": "First operational flight of LandSpace's Zhuque-2 rocket with 3 payloads: Tianyi-33 - 50 kg class satellite from TYSPACE & Hunan University of Science and Technology that tests various new technologies including a camera, new spacecraft thermal control, composite material for anti-radiation effects, high-output electric power supplies and payload control software using the Rust programming language; Honghu-1 & 2 - 50 kg class satellites for long term testing of Xenon & Krypton-based Hall-effect thrusters & Argon-based ion thrusters.",
    "launch_designator": null,
    "type": "Technology",
    "orbit": {
      "id": 17,
      "name": "Sun-Synchronous Orbit",
      "abbrev": "SSO"
    },
    "agencies": [],
    "info_urls": [],
    "vid_urls": []
  },
  "pad": {
    "id": 9,
    "url": "https://ll.thespacedevs.com/2.2.0/pad/9/?format=api",
    "agency_id": 259,
    "name": "Launch Area 96A",
    "description": "",
    "info_url": null,
    "wiki_url": "https://en.wikipedia.org/wiki/LandSpace",
    "map_url": "https://www.google.com/maps?q=40.91491,100.245488",
    "latitude": "40.91491",
    "longitude": "100.245488",
    "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": 294,
      "total_landing_count": 3
    },
    "country_code": "CHN",
    "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_9_20200803143341.jpg",
    "total_launch_count": 8,
    "orbital_launch_attempt_count": 8
  },
  "infoURLs": [],
  "vidURLs": [
    {
      "priority": 10,
      "source": "youtube.com",
      "publisher": "SciNews",
      "title": "ZhuQue-2 launches three satellites",
      "description": "LandSpace’s ZhuQue-2 launch vehicle (朱雀二, ZQ-2, 朱雀二号遥三, ZhuQue-2 Y3) launched three satellites, Honghu (鸿鹄卫星), Honghu-2 (鸿鹄二号卫星) and Tianyi-33 (天仪33卫星,TY-33)...",
      "feature_image": "https://i.ytimg.com/vi/QXrys6sNTvo/maxresdefault.jpg",
      "url": "https://www.youtube.com/watch?v=QXrys6sNTvo",
      "type": {
        "id": 6,
        "name": "Recap"
      },
      "language": {
        "id": 1,
        "name": "English",
        "code": "en"
      },
      "start_time": "2023-12-09T04:55:18Z",
      "end_time": "2023-12-09T04:58:03Z"
    }
  ],
  "webcast_live": false,
  "timeline": [],
  "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/zhuque-225202_image_20231209100246.jpeg",
  "infographic": null,
  "program": [],
  "orbital_launch_attempt_count": 6570,
  "location_launch_attempt_count": 213,
  "pad_launch_attempt_count": 3,
  "agency_launch_attempt_count": 4,
  "orbital_launch_attempt_count_year": 202,
  "location_launch_attempt_count_year": 31,
  "pad_launch_attempt_count_year": 2,
  "agency_launch_attempt_count_year": 2,
  "pad_turnaround": "P149DT22H39M3S",
  "mission_patches": [
    {
      "id": 955,
      "name": "ZQ-2 Y3",
      "priority": 10,
      "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/zq-22520y3_mission_patch_20231210172744.png",
      "agency": {
        "id": 259,
        "url": "https://ll.thespacedevs.com/2.2.0/agencies/259/?format=api",
        "name": "LandSpace",
        "type": "Commercial"
      }
    }
  ],
  "type": "detailed"
}