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/b2efbb2d-a233-44d8-8869-6960ae6d17f1/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
  "id": "b2efbb2d-a233-44d8-8869-6960ae6d17f1",
  "url": "https://ll.thespacedevs.com/2.2.0/launch/b2efbb2d-a233-44d8-8869-6960ae6d17f1/?format=api",
  "slug": "long-march-3b-shijian-13chinasat-16",
  "flightclub_url": null,
  "r_spacex_api_id": null,
  "name": "Long March 3B | Shijian-13/Chinasat-16",
  "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:28:52Z",
  "updates": [],
  "net": "2017-04-12T11:04:04Z",
  "net_precision": {
    "id": 0,
    "name": "Second",
    "abbrev": "SEC",
    "description": "The T-0 is accurate to the second."
  },
  "window_end": "2017-04-12T11:33:00Z",
  "window_start": "2017-04-12T10:58:00Z",
  "probability": null,
  "weather_concerns": null,
  "holdreason": "",
  "failreason": "",
  "hashtag": null,
  "launch_service_provider": {
    "id": 88,
    "url": "https://ll.thespacedevs.com/2.2.0/agencies/88/?format=api",
    "name": "China Aerospace Science and Technology Corporation",
    "featured": true,
    "type": "Government",
    "country_code": "CHN",
    "abbrev": "CASC",
    "description": "The China Aerospace Science and Technology Corporation (CASC) is the main contractor for the Chinese space program. It is state-owned and has a number of subordinate entities which design, develop and manufacture a range of spacecraft, launch vehicles, strategic and tactical missile systems, and ground equipment. It was officially established in July 1999 as part of a Chinese government reform drive, having previously been one part of the former China Aerospace Corporation. Various incarnations of the program date back to 1956.",
    "administrator": "Chairman & President: Lei Fanpei",
    "founding_year": "1999",
    "launchers": "Long March",
    "spacecraft": "",
    "launch_library_url": null,
    "total_launch_count": 600,
    "consecutive_successful_launches": 26,
    "successful_launches": 585,
    "failed_launches": 15,
    "pending_launches": 9,
    "consecutive_successful_landings": 0,
    "successful_landings": 0,
    "failed_landings": 1,
    "attempted_landings": 1,
    "info_url": "https://english.spacechina.com/",
    "wiki_url": "https://en.wikipedia.org/wiki/China_Aerospace_Science_and_Technology_Corporation",
    "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_logo_20220826093937.png",
    "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_image_20191228094408.jpeg",
    "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_nation_20230604193716.png"
  },
  "rocket": {
    "id": 1994,
    "configuration": {
      "id": 19,
      "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/19/?format=api",
      "name": "Long March 3B",
      "active": true,
      "reusable": false,
      "description": "The Long March 3B is a Chinese orbital carrier rocket. Introduced in 1996, it is launched from Launch Area 2 and 3 at the Xichang Satellite Launch Center in Sichuan. A three-stage rocket with four strap-on liquid rocket boosters, it is currently the most powerful member of the Long March rocket family and the heaviest of the Long March 3 rocket family, and is mainly used to place communications satellites into geosynchronous orbits.",
      "family": "Long March",
      "full_name": "Long March 3B",
      "manufacturer": {
        "id": 88,
        "url": "https://ll.thespacedevs.com/2.2.0/agencies/88/?format=api",
        "name": "China Aerospace Science and Technology Corporation",
        "featured": true,
        "type": "Government",
        "country_code": "CHN",
        "abbrev": "CASC",
        "description": "The China Aerospace Science and Technology Corporation (CASC) is the main contractor for the Chinese space program. It is state-owned and has a number of subordinate entities which design, develop and manufacture a range of spacecraft, launch vehicles, strategic and tactical missile systems, and ground equipment. It was officially established in July 1999 as part of a Chinese government reform drive, having previously been one part of the former China Aerospace Corporation. Various incarnations of the program date back to 1956.",
        "administrator": "Chairman & President: Lei Fanpei",
        "founding_year": "1999",
        "launchers": "Long March",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 600,
        "consecutive_successful_launches": 26,
        "successful_launches": 585,
        "failed_launches": 15,
        "pending_launches": 9,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 1,
        "attempted_landings": 1,
        "info_url": "https://english.spacechina.com/",
        "wiki_url": "https://en.wikipedia.org/wiki/China_Aerospace_Science_and_Technology_Corporation",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_logo_20220826093937.png",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_image_20191228094408.jpeg",
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520technology2520corporation_nation_20230604193716.png"
      },
      "program": [],
      "variant": "B",
      "alias": "",
      "min_stage": 0,
      "max_stage": 3,
      "length": 54.8,
      "diameter": 3.35,
      "maiden_flight": "1996-02-14",
      "launch_cost": "70000000",
      "launch_mass": 426,
      "leo_capacity": 11500,
      "gto_capacity": 5100,
      "to_thrust": 5923,
      "apogee": null,
      "vehicle_range": null,
      "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long2520march25203_image_20200102181012.jpg",
      "info_url": null,
      "wiki_url": "https://en.wikipedia.org/wiki/Long_March_3B",
      "total_launch_count": 24,
      "consecutive_successful_launches": 3,
      "successful_launches": 21,
      "failed_launches": 3,
      "pending_launches": 0,
      "attempted_landings": 0,
      "successful_landings": 0,
      "failed_landings": 0,
      "consecutive_successful_landings": 0
    },
    "launcher_stage": [],
    "spacecraft_stage": null
  },
  "mission": {
    "id": 414,
    "name": "Shijian-13/Chinasat-16",
    "description": "This is a Chinese experimental geostationary communications satellite. Besides testing the electric propulsion, the satellite is also reported to carry Chinas first high-throughput satellite payload (HTS), with a capacity of 20 GB per second. The satellite is aiming to provide Ka-band satellite broadband and multimedia services. Additionally it is also to conduct space-to-ground laser communications experiments.",
    "launch_designator": null,
    "type": "Communications",
    "orbit": {
      "id": 2,
      "name": "Geostationary Transfer Orbit",
      "abbrev": "GTO"
    },
    "agencies": [],
    "info_urls": [],
    "vid_urls": []
  },
  "pad": {
    "id": 66,
    "url": "https://ll.thespacedevs.com/2.2.0/pad/66/?format=api",
    "agency_id": 17,
    "name": "Launch Complex 3 (LC-3/LA-1)",
    "description": "",
    "info_url": null,
    "wiki_url": "https://en.wikipedia.org/wiki/Xichang_Satellite_Launch_Center",
    "map_url": "https://www.google.com/maps?q=28.247059,102.029008",
    "latitude": "28.247059",
    "longitude": "102.029008",
    "location": {
      "id": 16,
      "url": "https://ll.thespacedevs.com/2.2.0/location/16/?format=api",
      "name": "Xichang Satellite Launch Center, People's Republic of China",
      "country_code": "CHN",
      "description": "The Xichang Satellite Launch Center is a spaceport in China. It is located in Zeyuan Town, northwest of Xichang, Liangshan Yi Autonomous Prefecture in Sichuan.",
      "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_16_20200803142513.jpg",
      "timezone_name": "Asia/Shanghai",
      "total_launch_count": 241,
      "total_landing_count": 0
    },
    "country_code": "CHN",
    "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_66_20200803143611.jpg",
    "total_launch_count": 108,
    "orbital_launch_attempt_count": 108
  },
  "infoURLs": [],
  "vidURLs": [
    {
      "priority": 0,
      "source": "youtube.com",
      "publisher": "CGTN Español",
      "title": "China lanza el Shijian-13, un nuevo satélite que mejora el acceso a Internet",
      "description": "El satélite de comunicaciones más avanzado de China, el Shijian-13, fue lanzado desde el Centro de Lanzamiento de Satélites de la Provincia de Xichang a las 19:04 horas del miércoles. El Shijian-13 es...",
      "feature_image": "https://i.ytimg.com/vi/HT-u71Y9cfo/hqdefault.jpg",
      "url": "https://www.youtube.com/watch?v=HT-u71Y9cfo",
      "type": {
        "id": 6,
        "name": "Recap"
      },
      "language": {
        "id": 5,
        "name": "Spanish",
        "code": "es"
      },
      "start_time": "2017-04-13T07:43:38Z",
      "end_time": "2017-04-13T07:44:35Z"
    },
    {
      "priority": 0,
      "source": "youtube.com",
      "publisher": "CCTV Video News Agency",
      "title": "China Launches First High-throughput Communications Satellite Shijian-13",
      "description": "China successfully launched the Shijian-13, its first high-throughput communications satellite on Wednesday from the Xichang Satellite Launch Center in southwest China's Sichuan Province. \nThe satelli...",
      "feature_image": "https://i.ytimg.com/vi/jeSnTNtxtg0/hqdefault.jpg",
      "url": "https://www.youtube.com/watch?v=jeSnTNtxtg0",
      "type": {
        "id": 6,
        "name": "Recap"
      },
      "language": {
        "id": 1,
        "name": "English",
        "code": "en"
      },
      "start_time": "2017-04-13T01:44:38Z",
      "end_time": "2017-04-13T01:45:31Z"
    },
    {
      "priority": 0,
      "source": "youtube.com",
      "publisher": "SciNews",
      "title": "Shijian-13 (实践十三) launched by Long March-3B",
      "description": "A Long March-3B carrier rocket (长征三号乙, Chang Zheng-3B) launched Shijian-13 (实践十三) from the Xichang Satellite Launch Center in southwest China's Sichuan Province, on 12 April 2017, at 11:04 UTC (19:04 ...",
      "feature_image": "https://i.ytimg.com/vi/EG_V4mDn_YE/hqdefault.jpg",
      "url": "https://www.youtube.com/watch?v=EG_V4mDn_YE",
      "type": {
        "id": 6,
        "name": "Recap"
      },
      "language": {
        "id": 1,
        "name": "English",
        "code": "en"
      },
      "start_time": "2017-04-12T16:58:35Z",
      "end_time": "2017-04-12T17:00:03Z"
    }
  ],
  "webcast_live": false,
  "timeline": [],
  "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long2520march25203_image_20200102181012.jpg",
  "infographic": null,
  "program": [],
  "orbital_launch_attempt_count": 5634,
  "location_launch_attempt_count": 102,
  "pad_launch_attempt_count": 36,
  "agency_launch_attempt_count": 193,
  "orbital_launch_attempt_count_year": 19,
  "location_launch_attempt_count_year": 2,
  "pad_launch_attempt_count_year": 1,
  "agency_launch_attempt_count_year": 3,
  "pad_turnaround": "P122DT18H53M4S",
  "mission_patches": [],
  "type": "detailed"
}