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/b6779781-5a21-4811-adab-167adda1de97/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "b6779781-5a21-4811-adab-167adda1de97",
    "url": "https://ll.thespacedevs.com/2.0.0/launch/b6779781-5a21-4811-adab-167adda1de97/?format=api",
    "launch_library_id": 102,
    "slug": "vega-kazeosat-1",
    "name": "Vega | KazEOSat 1",
    "status": {
        "id": 3,
        "name": "Success"
    },
    "net": "2014-04-30T01:35:15Z",
    "window_end": "2014-04-30T01:35:15Z",
    "window_start": "2014-04-30T01:35:15Z",
    "inhold": false,
    "tbdtime": false,
    "tbddate": false,
    "probability": -1,
    "holdreason": "",
    "failreason": null,
    "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": 961,
        "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": 55,
        "launch_library_id": 88,
        "name": "DZZ-HR",
        "description": "DZZ-HR will provide high-resolution images to Kazakh authorities for homeland surveillance, resource management and environmental monitoring.",
        "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": "Arianespace Flight VV03 / KasEOSat-1",
            "description": "On Tuesday, April 29 at 10:35 pm local time in French Guiana, Arianespace successfully launched the third Vega launcher from the Guiana Space Center (CSG), o...",
            "feature_image": "https://i.ytimg.com/vi/gMtxV9kzGLg/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=gMtxV9kzGLg"
        }
    ],
    "webcast_live": false,
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega_image_20201111143622.jpeg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 5373,
    "location_launch_attempt_count": 236,
    "pad_launch_attempt_count": 29,
    "agency_launch_attempt_count": 221,
    "orbital_launch_attempt_count_year": 24,
    "location_launch_attempt_count_year": 4,
    "pad_launch_attempt_count_year": 1,
    "agency_launch_attempt_count_year": 4
}