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/ce4add79-a6fc-4591-a255-6a763d563f6f/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "ce4add79-a6fc-4591-a255-6a763d563f6f",
    "url": "https://ll.thespacedevs.com/2.0.0/launch/ce4add79-a6fc-4591-a255-6a763d563f6f/?format=api",
    "launch_library_id": 236,
    "slug": "vega-lisa-pathfinder",
    "name": "Vega | LISA Pathfinder",
    "status": {
        "id": 3,
        "name": "Success"
    },
    "net": "2015-12-03T04:04:01Z",
    "window_end": "2015-12-03T04:04:01Z",
    "window_start": "2015-12-03T04:04:01Z",
    "inhold": false,
    "tbdtime": false,
    "tbddate": false,
    "probability": null,
    "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": 1105,
        "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": 814,
        "launch_library_id": 145,
        "name": "LISA Pathfinder",
        "description": "LISA Pathfinder will pave the way for future missions by testing in flight the very concept of gravitational wave detection: it will put two test masses in a near-perfect gravitational free-fall and control and measure their motion with unprecedented accuracy. LISA Pathfinder will use the latest technology to minimise the extra forces on the test masses, and to take measurements. The inertial sensors, the laser metrology system, the drag-free control system and an ultra-precise micro-propulsion system make this a highly unusual mission.",
        "launch_designator": null,
        "type": "Astrophysics",
        "orbit": {
            "id": 5,
            "name": "Heliocentric L1",
            "abbrev": "L1-point"
        }
    },
    "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": "Liftoff of Vega Flight VV06 with LISA Pathfinder",
            "description": "The Vega mission with Europe’s pioneering LISA Pathfinder technology demonstrator is now underway following tonight’s liftoff from the Spaceport in French Gu...",
            "feature_image": "https://i.ytimg.com/vi/hqtHPr3mHrY/hqdefault.jpg",
            "url": "https://www.youtube.com/watch?v=hqtHPr3mHrY"
        }
    ],
    "webcast_live": false,
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega_image_20201111143622.jpeg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 5516,
    "location_launch_attempt_count": 254,
    "pad_launch_attempt_count": 32,
    "agency_launch_attempt_count": 239,
    "orbital_launch_attempt_count_year": 74,
    "location_launch_attempt_count_year": 11,
    "pad_launch_attempt_count_year": 3,
    "agency_launch_attempt_count_year": 11
}