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/68ab2654-f5ed-431f-a2cc-dbb392b4d7d8/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "68ab2654-f5ed-431f-a2cc-dbb392b4d7d8",
    "url": "https://ll.thespacedevs.com/2.0.0/launch/68ab2654-f5ed-431f-a2cc-dbb392b4d7d8/?format=api",
    "launch_library_id": 1071,
    "slug": "vega-adm-aeolus",
    "name": "Vega | ADM-Aeolus",
    "status": {
        "id": 3,
        "name": "Success"
    },
    "net": "2018-08-22T21:20:09Z",
    "window_end": "2018-08-22T21:20:09Z",
    "window_start": "2018-08-22T21:20:09Z",
    "inhold": false,
    "tbdtime": false,
    "tbddate": false,
    "probability": -1,
    "holdreason": "",
    "failreason": null,
    "hashtag": "#Aeolus",
    "launch_service_provider": {
        "id": 115,
        "url": "https://ll.thespacedevs.com/2.0.0/agencies/115/?format=api",
        "name": "Arianespace",
        "featured": true,
        "type": "Commercial",
        "country_code": "FRA",
        "abbrev": "ASA",
        "description": "Arianespace SA is a multinational company founded in 1980 as the world's first commercial launch service provider. It undertakes the production, operation, and marketing of the Ariane programme. Their vehicles launch exclusively from French Guiana in South America.",
        "administrator": "CEO: David Cavaillolès",
        "founding_year": "1980",
        "launchers": "Ariane | Vega",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 319,
        "consecutive_successful_launches": 7,
        "successful_launches": 304,
        "failed_launches": 15,
        "pending_launches": 48,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "http://www.arianespace.com",
        "wiki_url": "http://en.wikipedia.org/wiki/Arianespace",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianespace_logo_20210603173752.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/arianespace_nation_20230530190314.jpg"
    },
    "rocket": {
        "id": 1361,
        "configuration": {
            "id": 167,
            "launch_library_id": 18,
            "url": "https://ll.thespacedevs.com/2.0.0/config/launcher/167/?format=api",
            "name": "Vega",
            "description": "Vega is the smallest lifter in the current Arianespace family.",
            "family": "Vega",
            "full_name": "Vega",
            "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": 29.9,
            "diameter": 3.025,
            "maiden_flight": "2012-02-13",
            "launch_mass": 137,
            "leo_capacity": 1500,
            "gto_capacity": null,
            "to_thrust": 2974,
            "apogee": null,
            "vehicle_range": null,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega_image_20201111143622.jpeg",
            "info_url": "http://www.arianespace.com/vehicle/vega/",
            "wiki_url": "https://en.wikipedia.org/wiki/Vega_(rocket)",
            "total_launch_count": 22,
            "consecutive_successful_launches": 5,
            "successful_launches": 20,
            "failed_launches": 2,
            "pending_launches": 0
        },
        "launcher_stage": [],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 483,
        "launch_library_id": 640,
        "name": "ADM-Aeolus",
        "description": "ADM-Aeolus was an Earth observation satellite built by Airbus Defense and Space for ESA. Its goal was to directly observe wind profiles from space on a global scale and provide data that could improve weather forecasting and advance understanding of atmospherics dynamics and climate. The Aeolus satellite weighed around 1366 kg and flew in a low sun-synchronous orbit at about 400 km altitude. It was desorbited and reentered the Earth's atmosphere on July 28, 2023 at approximately  19:00 UTC.",
        "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": [
        {
            "priority": 0,
            "title": "Aeolus launch live by European Space Agency",
            "description": "Watch European Space Agency's Aeolus launch live on Livestream.com. Watch live as ESA’s Aeolus mission is launched on a Vega rocket from Europe’s Spaceport in Kourou, French Guiana.\n\nAeolus will use revolutionary laser technology to measure winds around the globe. These near-realtime observations wi...",
            "feature_image": "https://img.new.livestream.com/events/00000000007f1bbe/7696d7de-9a8c-4c19-9c9a-e98c929dc778.jpg",
            "url": "https://livestream.com/accounts/362/events/8330174/player"
        },
        {
            "priority": 0,
            "title": "Décollage du vol Vega 12 depuis le CSG",
            "description": "Ce 22 août, Vega a parfaitement réussi sa mission en plaçant sur orbite le satellite Aeolus de l'Agence spatiale européenne depuis le Centre Spatial Guyanais...",
            "feature_image": "https://i.ytimg.com/vi/pcigGeF9JBI/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=pcigGeF9JBI"
        },
        {
            "priority": 0,
            "title": "Arianespace Flight VV12 - Aeolus (EN)",
            "description": "Pour regarder le lancement en Français, veuillez cliquer ici: https://www.youtube.com/watch?v=A7gfsU5ss2s",
            "feature_image": "https://i.ytimg.com/vi/Z4XLImXKgSo/hqdefault.jpg",
            "url": "https://www.youtube.com/watch?v=Z4XLImXKgSo"
        }
    ],
    "webcast_live": false,
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega_image_20201111143622.jpeg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 5772,
    "location_launch_attempt_count": 282,
    "pad_launch_attempt_count": 38,
    "agency_launch_attempt_count": 267,
    "orbital_launch_attempt_count_year": 66,
    "location_launch_attempt_count_year": 5,
    "pad_launch_attempt_count_year": 1,
    "agency_launch_attempt_count_year": 5
}