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/6746f2a2-7237-4a16-879a-99ade71cf02b/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
  "id": "6746f2a2-7237-4a16-879a-99ade71cf02b",
  "url": "https://ll.thespacedevs.com/2.2.0/launch/6746f2a2-7237-4a16-879a-99ade71cf02b/?format=api",
  "slug": "ariane-5-g-maqsat-3-ard",
  "flightclub_url": null,
  "r_spacex_api_id": null,
  "name": "Ariane 5 G | MaqSat 3 & ARD",
  "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-15T13:48:44Z",
  "updates": [],
  "net": "1998-10-21T16:37:21Z",
  "net_precision": {
    "id": 0,
    "name": "Second",
    "abbrev": "SEC",
    "description": "The T-0 is accurate to the second."
  },
  "window_end": "1998-10-21T16:37:21Z",
  "window_start": "1998-10-21T16:37:21Z",
  "probability": null,
  "weather_concerns": null,
  "holdreason": "",
  "failreason": "",
  "hashtag": null,
  "launch_service_provider": {
    "id": 27,
    "url": "https://ll.thespacedevs.com/2.2.0/agencies/27/?format=api",
    "name": "European Space Agency",
    "featured": false,
    "type": "Multinational",
    "country_code": "FRA,ITA,DEU,ESP,CHE,GBR,AUT,SWE,BEL,PRT,NLD,HUN,POL,DNK,CZE,ROU,NOR,FIN,GRC,EST,IRL,LUX,SVN",
    "abbrev": "ESA",
    "description": "The European Space Agency is an intergovernmental organisation of 22 member states. Established in 1975 and headquartered in Paris, France, ESA has a worldwide staff of about 2,000 employees.\r\n\r\nESA's space flight programme includes human spaceflight (mainly through participation in the International Space Station program); the launch and operation of unmanned exploration missions to other planets and the Moon; Earth observation, science and telecommunication; designing launch vehicles; and maintaining a major spaceport, the Guiana Space Centre at Kourou, French Guiana.",
    "administrator": "Director General: Josef Aschbacher",
    "founding_year": "1975",
    "launchers": "Ariane | Vega",
    "spacecraft": "Space Rider",
    "launch_library_url": null,
    "total_launch_count": 7,
    "consecutive_successful_launches": 5,
    "successful_launches": 6,
    "failed_launches": 1,
    "pending_launches": 1,
    "consecutive_successful_landings": 0,
    "successful_landings": 0,
    "failed_landings": 0,
    "attempted_landings": 0,
    "info_url": "https://www.esa.int/",
    "wiki_url": "https://en.wikipedia.org/wiki/European_Space_Agency",
    "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/european2520space2520agency_logo_20221130101442.png",
    "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/esa_patch_float_image_20250211192109.png",
    "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/european2520space2520agency_logo_20221130101442.png"
  },
  "rocket": {
    "id": 436,
    "configuration": {
      "id": 131,
      "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/131/?format=api",
      "name": "Ariane 5 G",
      "active": false,
      "reusable": false,
      "description": "The original version is dubbed Ariane 5 G (Generic) and had a launch mass of 737 tonnes. Its payload capability to geostationary transfer orbit (GTO) was 6,900 kg (15,200 lb) for a single satellite or 6,100 kg (13,400 lb) for dual launches. It flew 17 times with one failure and two partial failures.",
      "family": "Ariane",
      "full_name": "Ariane 5 G",
      "manufacturer": {
        "id": 1044,
        "url": "https://ll.thespacedevs.com/2.2.0/agencies/1044/?format=api",
        "name": "ArianeGroup",
        "featured": false,
        "type": "Commercial",
        "country_code": "FRA",
        "abbrev": "AG",
        "description": "ArianeGroup (formerly Airbus Safran Launchers) is an aerospace company based in France. A joint venture between Airbus and Safran, the company was founded in 2015 and is headquartered in Issy-les-Moulineaux. It consists of three core arms: aerospace, defence and security.",
        "administrator": "CEO: Christophe Bruneau",
        "founding_year": "2015",
        "launchers": "Ariane",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 0,
        "consecutive_successful_launches": 0,
        "successful_launches": 0,
        "failed_launches": 0,
        "pending_launches": 0,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "https://www.ariane.group/",
        "wiki_url": "https://en.wikipedia.org/wiki/ArianeGroup",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianegroup_logo_20221130111224.PNG",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane_62_on_el_image_20240708201807.jpeg",
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianegroup_nation_20230802053255.jpg"
      },
      "program": [],
      "variant": "G",
      "alias": "",
      "min_stage": 0,
      "max_stage": 2,
      "length": 57.0,
      "diameter": 5.4,
      "maiden_flight": "1996-06-04",
      "launch_cost": null,
      "launch_mass": 737,
      "leo_capacity": 12200,
      "gto_capacity": 6900,
      "to_thrust": null,
      "apogee": 40000,
      "vehicle_range": null,
      "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane252052520g_image_20190222030331.jpeg",
      "info_url": null,
      "wiki_url": "https://en.wikipedia.org/wiki/Ariane_5",
      "total_launch_count": 16,
      "consecutive_successful_launches": 6,
      "successful_launches": 13,
      "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": 576,
    "name": " MaqSat 3 & ARD",
    "description": "MaqSat 3 was a dummy satellite to test the Ariane Vehicle. ARD was the Advanced Reentry Demonstrator, built by ESA. This is developed for experimental purposes to validate reentry techniques.",
    "launch_designator": null,
    "type": "Dedicated Rideshare",
    "orbit": {
      "id": 2,
      "name": "Geostationary Transfer Orbit",
      "abbrev": "GTO"
    },
    "agencies": [],
    "info_urls": [],
    "vid_urls": []
  },
  "pad": {
    "id": 77,
    "url": "https://ll.thespacedevs.com/2.2.0/pad/77/?format=api",
    "agency_id": 115,
    "name": "Ariane Launch Area 3",
    "description": "ELA-3, is a launch pad and associated facilities at the Centre Spatial Guyanais in French Guiana. ELA-3 was operated by Arianespace as part of the expendable launch system for Ariane 5 launch vehicles.",
    "info_url": null,
    "wiki_url": "https://en.wikipedia.org/wiki/ELA-3",
    "map_url": "https://www.google.com/maps?q=5.239,-52.768",
    "latitude": "5.239",
    "longitude": "-52.768",
    "location": {
      "id": 13,
      "url": "https://ll.thespacedevs.com/2.2.0/location/13/?format=api",
      "name": "Guiana Space Centre, French Guiana",
      "country_code": "GUF",
      "description": "The Guiana Space Centre is a European spaceport to the northwest of Kourou in French Guiana, a region of France in South America. Kourou is located at a latitude of 5°. In operation since 1968, it is a suitable location for a spaceport because of its equatorial location and open sea to the east.",
      "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_13_20200803142412.jpg",
      "timezone_name": "America/Cayenne",
      "total_launch_count": 332,
      "total_landing_count": 0
    },
    "country_code": "GUF",
    "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_77_20200803143458.jpg",
    "total_launch_count": 118,
    "orbital_launch_attempt_count": 118
  },
  "infoURLs": [],
  "vidURLs": [],
  "webcast_live": false,
  "timeline": [],
  "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane252052520g_image_20190222030331.jpeg",
  "infographic": null,
  "program": [],
  "orbital_launch_attempt_count": 4271,
  "location_launch_attempt_count": 121,
  "pad_launch_attempt_count": 3,
  "agency_launch_attempt_count": 3,
  "orbital_launch_attempt_count_year": 64,
  "location_launch_attempt_count_year": 8,
  "pad_launch_attempt_count_year": 1,
  "agency_launch_attempt_count_year": 1,
  "pad_turnaround": "P356DT2H54M21S",
  "mission_patches": [],
  "type": "detailed"
}