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/edb154a1-00c0-4260-b6bf-d8903f0a97e5/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "edb154a1-00c0-4260-b6bf-d8903f0a97e5",
    "url": "https://ll.thespacedevs.com/2.0.0/launch/edb154a1-00c0-4260-b6bf-d8903f0a97e5/?format=api",
    "launch_library_id": 1194,
    "slug": "vega-gokturk-1a",
    "name": "Vega | Göktürk-1A",
    "status": {
        "id": 3,
        "name": "Success"
    },
    "net": "2016-12-05T13:51:44Z",
    "window_end": "2016-12-05T14:22:00Z",
    "window_start": "2016-12-05T12:51:00Z",
    "inhold": false,
    "tbdtime": false,
    "tbddate": false,
    "probability": -1,
    "holdreason": "",
    "failreason": "",
    "hashtag": null,
    "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": 1194,
        "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": 338,
        "launch_library_id": 443,
        "name": "Göktürk-1A",
        "description": "Göktürk-1A is a high resolution earth observation satellite (greater than 50 cm) designed and developed for the Turkish Ministry of National Defence by the Italian space service company Telespazio. The Göktürk-1A satellite has a dry weight of about 1,000 kg and a design life of seven years. Its observation payload includes a high resolution optical instrument and an onboard X-band digital imaging system to handle data compression, storage and downloading.",
        "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": "Images rapprochées du décollage de Vega",
            "description": "Un décollage de Vega comme vous ne l'avez jamais vu. Des images impressionnantes prises, par des caméras résistantes aux conditions extrêmes, installées au p...",
            "feature_image": "https://i.ytimg.com/vi/naQ0rhABi6g/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=naQ0rhABi6g"
        },
        {
            "priority": 0,
            "title": "Arianespace Flight VV08 - Behind the Scenes of the Dream",
            "description": "Relive Flight VV08 as you have never seen a Vega launch before! Get up close to this latest success with our special launch video.",
            "feature_image": "https://i.ytimg.com/vi/H_Yfo8ZEAGs/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=H_Yfo8ZEAGs"
        }
    ],
    "webcast_live": false,
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega_image_20201111143622.jpeg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 5605,
    "location_launch_attempt_count": 265,
    "pad_launch_attempt_count": 34,
    "agency_launch_attempt_count": 250,
    "orbital_launch_attempt_count_year": 76,
    "location_launch_attempt_count_year": 10,
    "pad_launch_attempt_count_year": 2,
    "agency_launch_attempt_count_year": 10
}