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/f5b5ef3e-aa66-4c4e-914c-6a9da0349648/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "f5b5ef3e-aa66-4c4e-914c-6a9da0349648",
    "url": "https://ll.thespacedevs.com/2.0.0/launch/f5b5ef3e-aa66-4c4e-914c-6a9da0349648/?format=api",
    "launch_library_id": null,
    "slug": "vega-c-harmony",
    "name": "Vega-C | Harmony",
    "status": {
        "id": 2,
        "name": "TBD"
    },
    "net": "2029-12-31T00:00:00Z",
    "window_end": "2029-12-31T00:00:00Z",
    "window_start": "2029-12-31T00:00:00Z",
    "inhold": false,
    "tbdtime": true,
    "tbddate": true,
    "probability": null,
    "holdreason": "",
    "failreason": "",
    "hashtag": null,
    "launch_service_provider": {
        "id": 159,
        "url": "https://ll.thespacedevs.com/2.0.0/agencies/159/?format=api",
        "name": "Avio S.p.A",
        "featured": true,
        "type": "Commercial",
        "country_code": "ITA",
        "abbrev": "Avio",
        "description": "Avio S.p.A. is an Italian company operating in the aerospace sector with its head office in Colleferro near Rome, Italy. Founded in 1908, it is present in Italy and abroad with different commercial offices and 10 production sites.",
        "administrator": "CEO: Giulio Ranzo",
        "founding_year": "1908",
        "launchers": "Vega",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 0,
        "consecutive_successful_launches": 0,
        "successful_launches": 0,
        "failed_launches": 0,
        "pending_launches": 3,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "https://www.avio.com/",
        "wiki_url": "http://en.wikipedia.org/wiki/Avio",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/avio2520s.p.a_logo_20221130103121.png",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega-c_image_20220713154437.jpg",
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/avio_social_log_image_20250211190007.jpg"
    },
    "rocket": {
        "id": 8381,
        "configuration": {
            "id": 127,
            "launch_library_id": 163,
            "url": "https://ll.thespacedevs.com/2.0.0/config/launcher/127/?format=api",
            "name": "Vega-C",
            "description": "Vega-C is a single-body rocket nearly 35 m high with that weighs 210 tonnes on the launch pad. As with Vega, its main elements are three solid-propellant stages, an upper stage powered by a reignitable liquid-propellant engine and a payload fairing. Vega-C's P120C first stage replaces Vega’s smaller P80 to provide a significant increase in thrust at liftoff. It is also used as boosters (2 or 4) for the Ariane 6 rocket.",
            "family": "Vega",
            "full_name": "Vega-C",
            "manufacturer": {
                "id": 159,
                "url": "https://ll.thespacedevs.com/2.0.0/agencies/159/?format=api",
                "name": "Avio S.p.A",
                "featured": true,
                "type": "Commercial",
                "country_code": "ITA",
                "abbrev": "Avio",
                "description": "Avio S.p.A. is an Italian company operating in the aerospace sector with its head office in Colleferro near Rome, Italy. Founded in 1908, it is present in Italy and abroad with different commercial offices and 10 production sites.",
                "administrator": "CEO: Giulio Ranzo",
                "founding_year": "1908",
                "launchers": "Vega",
                "spacecraft": "",
                "launch_library_url": null,
                "total_launch_count": 0,
                "consecutive_successful_launches": 0,
                "successful_launches": 0,
                "failed_launches": 0,
                "pending_launches": 3,
                "consecutive_successful_landings": 0,
                "successful_landings": 0,
                "failed_landings": 0,
                "attempted_landings": 0,
                "info_url": "https://www.avio.com/",
                "wiki_url": "http://en.wikipedia.org/wiki/Avio",
                "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/avio2520s.p.a_logo_20221130103121.png",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega-c_image_20220713154437.jpg",
                "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/avio_social_log_image_20250211190007.jpg"
            },
            "program": [],
            "variant": "",
            "alias": "",
            "min_stage": 4,
            "max_stage": 4,
            "length": 35.0,
            "diameter": 3.0,
            "maiden_flight": "2022-07-13",
            "launch_mass": 210,
            "leo_capacity": 3300,
            "gto_capacity": null,
            "to_thrust": 2974,
            "apogee": null,
            "vehicle_range": null,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega-c_image_20220713154437.jpg",
            "info_url": "http://www.arianespace.com/vehicle/vega/",
            "wiki_url": "https://en.wikipedia.org/wiki/Vega_(rocket)",
            "total_launch_count": 4,
            "consecutive_successful_launches": 2,
            "successful_launches": 3,
            "failed_launches": 1,
            "pending_launches": 23
        },
        "launcher_stage": [],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 6962,
        "launch_library_id": null,
        "name": "Harmony",
        "description": "Harmony, ESA's 10th Earth Explorer mission, consists of 2 satellites that will orbit Earth in tandem with a Copernicus Sentinel-1 satellite in various configurations. The Harmony satellites’ synthetic aperture radar instruments will receive the Sentinel-1 satellite's radar signals that bounce back, or ‘backscatter’, from Earth’s surface. At the same time, Harmony’s thermal-infrared instruments provide complementary observations of the sea surface as well as the position and motion of clouds above it.",
        "launch_designator": null,
        "type": "Earth Science",
        "orbit": {
            "id": 17,
            "name": "Sun-Synchronous Orbit",
            "abbrev": "SSO"
        }
    },
    "pad": {
        "id": 34,
        "url": "https://ll.thespacedevs.com/2.0.0/pad/34/?format=api",
        "agency_id": 115,
        "name": "Ariane Launch Area 1 (ELV)",
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/ELA-1",
        "map_url": "https://www.google.com/maps?q=5.236,-52.775",
        "latitude": "5.236",
        "longitude": "-52.775",
        "location": {
            "id": 13,
            "url": "https://ll.thespacedevs.com/2.0.0/location/13/?format=api",
            "name": "Guiana Space Centre, French Guiana",
            "country_code": "GUF",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_13_20200803142412.jpg",
            "total_launch_count": 325,
            "total_landing_count": 0
        },
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_34_20200803143527.jpg",
        "total_launch_count": 52
    },
    "infoURLs": [],
    "vidURLs": [],
    "webcast_live": false,
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega-c_image_20220713154437.jpg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 7263,
    "location_launch_attempt_count": 366,
    "pad_launch_attempt_count": 74,
    "agency_launch_attempt_count": 3,
    "orbital_launch_attempt_count_year": 16,
    "location_launch_attempt_count_year": 4,
    "pad_launch_attempt_count_year": 2,
    "agency_launch_attempt_count_year": 2
}