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/fb414fb8-c7c4-4b98-9057-8ffdc563bec6/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "fb414fb8-c7c4-4b98-9057-8ffdc563bec6",
    "url": "https://ll.thespacedevs.com/2.0.0/launch/fb414fb8-c7c4-4b98-9057-8ffdc563bec6/?format=api",
    "launch_library_id": 512,
    "slug": "soyuz-stafregat-sentinel-1b",
    "name": "Soyuz STA/Fregat | Sentinel-1B",
    "status": {
        "id": 3,
        "name": "Success"
    },
    "net": "2016-04-25T21:02:13Z",
    "window_end": "2016-04-25T21:02:13Z",
    "window_start": "2016-04-25T21:02:13Z",
    "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": 1922,
        "configuration": {
            "id": 49,
            "launch_library_id": 76,
            "url": "https://ll.thespacedevs.com/2.0.0/config/launcher/49/?format=api",
            "name": "Soyuz STA",
            "description": "The 2.1a version includes conversion from analog to digital flight control system and uprated engines on the booster and the first stage with improved injection systems. The new digital flight control and telemetry systems allow the rocket to launch from a fixed rather than angled launch platform and adjust its heading in flight. A digital control system also enables the launch of larger commercial satellites with wider and longer payload fairings such as the ST-type fairing. These fairings introduce too much aerodynamic instability for the old analog system to handle. This stage continues to use the RD-0110 engine.\r\n\r\nThe 2.1a/ST version is sometimes called Soyuz ST-A.",
            "family": "Soyuz",
            "full_name": "Soyuz STA Fregat",
            "manufacturer": {
                "id": 111,
                "url": "https://ll.thespacedevs.com/2.0.0/agencies/111/?format=api",
                "name": "Progress Rocket Space Center",
                "featured": false,
                "type": "Commercial",
                "country_code": "RUS",
                "abbrev": "PRSC",
                "description": "Progress Rocket Space Centre, formerly known as TsSKB-Progress, is a space science and aerospace research company which is known for manufacturing launch vehicles and satellites. Most notably, Progress Rocket Space Centre is the manufacturer of Soyuz launch vehicles.",
                "administrator": "CEO: Dmitry Baranov",
                "founding_year": "1996",
                "launchers": "",
                "spacecraft": "",
                "launch_library_url": null,
                "total_launch_count": 45,
                "consecutive_successful_launches": 3,
                "successful_launches": 44,
                "failed_launches": 1,
                "pending_launches": 0,
                "consecutive_successful_landings": 0,
                "successful_landings": 0,
                "failed_landings": 0,
                "attempted_landings": 0,
                "info_url": "https://en.samspace.ru/",
                "wiki_url": "https://en.wikipedia.org/wiki/Progress_Rocket_Space_Centre",
                "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/progress2520rocket2520space2520center_logo_20210313175054.png",
                "image_url": null,
                "nation_url": null
            },
            "program": [],
            "variant": "Fregat",
            "alias": "",
            "min_stage": 3,
            "max_stage": 3,
            "length": 46.3,
            "diameter": 2.95,
            "maiden_flight": "2011-12-17",
            "launch_mass": 312,
            "leo_capacity": 7020,
            "gto_capacity": 2810,
            "to_thrust": null,
            "apogee": null,
            "vehicle_range": null,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz2520sta_image_20191210133244.jpg",
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/Soyuz-2_(rocket)",
            "total_launch_count": 8,
            "consecutive_successful_launches": 8,
            "successful_launches": 8,
            "failed_launches": 0,
            "pending_launches": 0
        },
        "launcher_stage": [],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 163,
        "launch_library_id": 198,
        "name": "Sentinel-1B",
        "description": "Sentinel-1 is a two satellite constellation for land and ocean monitoring. C-band imaging will provide an all-weather day-and-night supply of imagery for Copernicus user services. This is the second and last satellite launched of the pair.",
        "launch_designator": null,
        "type": "Earth Science",
        "orbit": {
            "id": 17,
            "name": "Sun-Synchronous Orbit",
            "abbrev": "SSO"
        }
    },
    "pad": {
        "id": 81,
        "url": "https://ll.thespacedevs.com/2.0.0/pad/81/?format=api",
        "agency_id": 115,
        "name": "Soyuz Launch Complex",
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/Ensemble_de_Lancement_Soyouz",
        "map_url": "https://www.google.com/maps?q=5.3019,-52.8346",
        "latitude": "5.3019",
        "longitude": "-52.8346",
        "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_81_20200803143601.jpg",
        "total_launch_count": 26
    },
    "infoURLs": [],
    "vidURLs": [
        {
            "priority": 0,
            "title": "Arianespace Flight VS14 /Sentinel-1B",
            "description": "FLIGHT VS14 – a successful ARIANESPACE launch, with Soyuz, Supporting sustainable development, fundamental physics and promoting space careers Arianespace su...",
            "feature_image": "https://i.ytimg.com/vi/8fQZra537vM/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=8fQZra537vM"
        },
        {
            "priority": 0,
            "title": "Sentinel-1B lifts off",
            "description": "Sentinel-1B lifted off on a Soyuz rocket, flight VS14, from Europe’s Spaceport in French Guiana on 25 April 2016 at 21:02 GMT (23:02 CEST). With the Sentinel...",
            "feature_image": "https://i.ytimg.com/vi/At8Ztfacdi4/hqdefault.jpg",
            "url": "https://www.youtube.com/watch?v=At8Ztfacdi4"
        }
    ],
    "webcast_live": false,
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz2520sta_image_20191210133244.jpg",
    "infographic": null,
    "program": [
        {
            "id": 22,
            "url": "https://ll.thespacedevs.com/2.0.0/program/22/?format=api",
            "name": "Copernicus",
            "description": "Copernicus is the European Union's Earth observation programme coordinated and managed for the European Commission by the European Union Agency for the Space Programme in partnership with the European Space Agency (ESA), the EU Member States. It aims at achieving a global, continuous, autonomous, high quality, wide range Earth observation capacity. Providing accurate, timely and easily accessible information to, among other things, improve the management of the environment, understand and mitigate the effects of climate change, and ensure civil security.",
            "agencies": [
                {
                    "id": 27,
                    "url": "https://ll.thespacedevs.com/2.0.0/agencies/27/?format=api",
                    "name": "European Space Agency",
                    "type": "Multinational"
                },
                {
                    "id": 1043,
                    "url": "https://ll.thespacedevs.com/2.0.0/agencies/1043/?format=api",
                    "name": "European Union Agency for the Space Programme",
                    "type": "Multinational"
                }
            ],
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/copernicus_program_20221129162831.png",
            "start_date": "2014-04-03T00:00:00Z",
            "end_date": null,
            "info_url": "https://www.copernicus.eu",
            "wiki_url": "https://en.wikipedia.org/wiki/Copernicus_Programme"
        }
    ],
    "orbital_launch_attempt_count": 5554,
    "location_launch_attempt_count": 258,
    "pad_launch_attempt_count": 14,
    "agency_launch_attempt_count": 243,
    "orbital_launch_attempt_count_year": 25,
    "location_launch_attempt_count_year": 3,
    "pad_launch_attempt_count_year": 1,
    "agency_launch_attempt_count_year": 3
}