AN API endpoint that returns all Launch objects or a single launch.

EXAMPLE - /launch/[id]/ 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', 'is_crewed', 'include_suborbital', 'spacecraft_config__ids', 'related', 'location__ids', 'lsp__ids', 'pad__ids', 'status__ids'

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.2.0/launch/aa79ad61-9276-4c14-8d01-40fd348d641e/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "aa79ad61-9276-4c14-8d01-40fd348d641e",
    "url": "https://ll.thespacedevs.com/2.2.0/launch/aa79ad61-9276-4c14-8d01-40fd348d641e/?format=api",
    "slug": "vega-c-sentinel-1c",
    "flightclub_url": null,
    "r_spacex_api_id": null,
    "name": "Vega-C | Sentinel-1C",
    "status": {
        "id": 3,
        "name": "Launch Successful",
        "abbrev": "Success",
        "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)."
    },
    "last_updated": "2024-12-09T14:31:42Z",
    "updates": [
        {
            "id": 9432,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg",
            "comment": "Launch success",
            "info_url": "https://x.com/esa/status/1864813155060453849",
            "created_by": "SwGustav",
            "created_on": "2024-12-06T01:32:00Z"
        },
        {
            "id": 9430,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/lucas2520stauder_profile_20230526163835.jpg",
            "comment": "Liftoff!",
            "info_url": "https://www.youtube.com/watch?v=gt3kWdS9EJo",
            "created_by": "hitura-nobad",
            "created_on": "2024-12-05T21:20:00Z"
        },
        {
            "id": 9429,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/ll2_profile_20230311134739.png",
            "comment": "Official Webcast by arianespace has started",
            "info_url": "https://www.youtube.com/watch?v=gt3kWdS9EJo",
            "created_by": "LL2",
            "created_on": "2024-12-05T20:42:00Z"
        },
        {
            "id": 9408,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
            "comment": "Delayed by a day due to a mechanical issue preventing the withdrawal of the mobile gantry",
            "info_url": "https://x.com/Arianespace/status/1864392156766429611",
            "created_by": "Nosu",
            "created_on": "2024-12-04T19:37:00Z"
        },
        {
            "id": 9375,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Tweaked T-0.",
            "info_url": "https://newsroom.arianespace.com/download?zip=2&pictures=42485",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-11-30T04:31:00Z"
        },
        {
            "id": 9366,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Rescheduled for December 4.",
            "info_url": "https://x.com/arianespace/status/1862194511167771008",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-11-28T19:50:00Z"
        },
        {
            "id": 9352,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Delayed due to launch vehicle problem, new date TBD.",
            "info_url": "https://x.com/arianespace/status/1861730974481977724",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-11-27T11:36:00Z"
        },
        {
            "id": 8812,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "NET December 3.",
            "info_url": "https://newsroom.arianespace.com/arianespace-to-launch-copernicus-sentinel-1c-satellite-on-december-3",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-10-10T11:21:00Z"
        },
        {
            "id": 8637,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "NET Late November.",
            "info_url": "https://spacenews.com/software-fix-planned-to-correct-ariane-6-upper-stage-issue/",
            "created_by": "Cosmic_Penguin",
            "created_on": "2024-09-18T11:08:00Z"
        },
        {
            "id": 6251,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
            "comment": "NET November 15",
            "info_url": "https://europeanspaceflight.com/esa-targets-15-november-for-vega-c-return-to-flight-mission/",
            "created_by": "Nosu",
            "created_on": "2024-01-11T15:08:31Z"
        },
        {
            "id": 5116,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
            "comment": "TBD 2024",
            "info_url": "https://twitter.com/AndrewParsonson/status/1701206871762227694",
            "created_by": "Nosu",
            "created_on": "2023-09-11T12:24:51Z"
        },
        {
            "id": 4542,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png",
            "comment": "Moving to Q1 2024 pending investigations into Vega-C 2nd stage motor re-qualification test firing failure.",
            "info_url": "https://europeanspaceflight.com/vega-c-return-to-flight-delayed-after-z40-test-failure/",
            "created_by": "Cosmic_Penguin",
            "created_on": "2023-07-09T03:03:07Z"
        },
        {
            "id": 1556,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
            "comment": "Adding launch",
            "info_url": "https://spacenews.com/vega-c-to-launch-sentinel-1c-in-2023/",
            "created_by": "Nosu",
            "created_on": "2022-04-10T07:10:52Z"
        }
    ],
    "net": "2024-12-05T21:20:33Z",
    "net_precision": {
        "id": 0,
        "name": "Second",
        "abbrev": "SEC",
        "description": "The T-0 is accurate to the second."
    },
    "window_end": "2024-12-05T21:20:33Z",
    "window_start": "2024-12-05T21:20:33Z",
    "probability": null,
    "weather_concerns": null,
    "holdreason": "",
    "failreason": "",
    "hashtag": null,
    "launch_service_provider": {
        "id": 115,
        "url": "https://ll.thespacedevs.com/2.2.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": 318,
        "consecutive_successful_launches": 6,
        "successful_launches": 303,
        "failed_launches": 15,
        "pending_launches": 49,
        "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": 7563,
        "configuration": {
            "id": 127,
            "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/127/?format=api",
            "name": "Vega-C",
            "active": true,
            "reusable": false,
            "description": "Vega-C is a single-body rocket nearly 35 m high with that weighs 210 tonnes on the launch pad. As with Vega, its main elements are three solid-propellant stages, an upper stage powered by a reignitable liquid-propellant engine and a payload fairing. Vega-C's P120C first stage replaces Vega’s smaller P80 to provide a significant increase in thrust at liftoff. It is also used as boosters (2 or 4) for the Ariane 6 rocket.",
            "family": "Vega",
            "full_name": "Vega-C",
            "manufacturer": {
                "id": 159,
                "url": "https://ll.thespacedevs.com/2.2.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": 35.0,
            "diameter": 3.0,
            "maiden_flight": "2022-07-13",
            "launch_cost": "48000000",
            "launch_mass": 210,
            "leo_capacity": 3300,
            "gto_capacity": null,
            "to_thrust": 2974,
            "apogee": null,
            "vehicle_range": null,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega-c_image_20220713154437.jpg",
            "info_url": "http://www.arianespace.com/vehicle/vega/",
            "wiki_url": "https://en.wikipedia.org/wiki/Vega_(rocket)",
            "total_launch_count": 3,
            "consecutive_successful_launches": 1,
            "successful_launches": 2,
            "failed_launches": 1,
            "pending_launches": 24,
            "attempted_landings": 0,
            "successful_landings": 0,
            "failed_landings": 0,
            "consecutive_successful_landings": 0
        },
        "launcher_stage": [],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 6234,
        "name": "Sentinel-1C",
        "description": "Sentinel-1C carries an advanced radar technology to provide an all-weather, day-and-night supply of imagery of Earth’s surface. It is a replacement satellite to complete the Sentinel-1 duo after Sentinel-1B suffered a technical anomaly.",
        "launch_designator": null,
        "type": "Earth Science",
        "orbit": {
            "id": 17,
            "name": "Sun-Synchronous Orbit",
            "abbrev": "SSO"
        },
        "agencies": [
            {
                "id": 27,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/27/?format=api",
                "name": "European Space Agency",
                "featured": false,
                "type": "Multinational",
                "country_code": "FRA,ITA,DEU,ESP,CHE,GBR,AUT,SWE,BEL,PRT,NLD,HUN,POL,DNK,CZE,ROU,NOR,FIN,GRC,EST,IRL,LUX,SVN",
                "abbrev": "ESA",
                "description": "The European Space Agency is an intergovernmental organisation of 22 member states. Established in 1975 and headquartered in Paris, France, ESA has a worldwide staff of about 2,000 employees.\r\n\r\nESA's space flight programme includes human spaceflight (mainly through participation in the International Space Station program); the launch and operation of unmanned exploration missions to other planets and the Moon; Earth observation, science and telecommunication; designing launch vehicles; and maintaining a major spaceport, the Guiana Space Centre at Kourou, French Guiana.",
                "administrator": "Director General: Josef Aschbacher",
                "founding_year": "1975",
                "launchers": "Ariane | Vega",
                "spacecraft": "Space Rider",
                "launch_library_url": null,
                "total_launch_count": 7,
                "consecutive_successful_launches": 5,
                "successful_launches": 6,
                "failed_launches": 1,
                "pending_launches": 0,
                "consecutive_successful_landings": 0,
                "successful_landings": 0,
                "failed_landings": 0,
                "attempted_landings": 0,
                "info_url": "http://www.esa.int/",
                "wiki_url": "http://en.wikipedia.org/wiki/European_Space_Agency",
                "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/european2520space2520agency_logo_20221130101442.png",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/esa_patch_float_image_20250211192109.png",
                "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/european2520space2520agency_logo_20221130101442.png"
            }
        ],
        "info_urls": [],
        "vid_urls": []
    },
    "pad": {
        "id": 34,
        "url": "https://ll.thespacedevs.com/2.2.0/pad/34/?format=api",
        "agency_id": 115,
        "name": "Ariane Launch Area 1 (ELV)",
        "description": "ELA-1, now named Ensemble de Lancement Vega (short ELV), is a launch pad at the Centre Spatial Guyanais in French Guiana. It has been used to support launches of the Europa rocket, Ariane 1, Ariane 3, and is currently used to launch Vega rockets.",
        "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.2.0/location/13/?format=api",
            "name": "Guiana Space Centre, French Guiana",
            "country_code": "GUF",
            "description": "The Guiana Space Centre is a European spaceport to the northwest of Kourou in French Guiana, a region of France in South America. Kourou is located at a latitude of 5°. In operation since 1968, it is a suitable location for a spaceport because of its equatorial location and open sea to the east.",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_13_20200803142412.jpg",
            "timezone_name": "America/Cayenne",
            "total_launch_count": 324,
            "total_landing_count": 0
        },
        "country_code": "GUF",
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_34_20200803143527.jpg",
        "total_launch_count": 51,
        "orbital_launch_attempt_count": 51
    },
    "infoURLs": [],
    "vidURLs": [
        {
            "priority": 9,
            "source": "youtube.com",
            "publisher": "arianespace",
            "title": "Flight VV25 – Sentinel-1C | Vega C Launch  I Arianespace",
            "description": "On Thursday December 5, 2024, the Vega C launcher (VV25 mission) lifted-off from the Guiana Space Center, French Guiana, at 6:20 pm local time (9:20 p.m. UTC, 10:20 p.m. CET). Vega C successfully plac...",
            "feature_image": "https://i.ytimg.com/vi/gt3kWdS9EJo/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=gt3kWdS9EJo",
            "type": {
                "id": 1,
                "name": "Official Webcast"
            },
            "language": {
                "id": 1,
                "name": "English",
                "code": "en"
            },
            "start_time": "2024-12-05T20:42:21Z",
            "end_time": "2024-12-05T23:32:18Z"
        },
        {
            "priority": 10,
            "source": "youtube.com",
            "publisher": "arianespace",
            "title": "Vol VV25 – Sentinel-1C | Lancement Vega C I Arianespace",
            "description": "Le jeudi 5 décembre 2024 à 18h20 heure locale (21h20 UTC et 22h20 CET), le lanceur Vega C (mission VV25) a décollé du port spatial européen de Kourou, en Guyane française, plaçant avec succès le satel...",
            "feature_image": "https://i.ytimg.com/vi/4XVo-c9E9LQ/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=4XVo-c9E9LQ",
            "type": {
                "id": 1,
                "name": "Official Webcast"
            },
            "language": {
                "id": 4,
                "name": "French",
                "code": "fr"
            },
            "start_time": "2024-12-05T20:42:11Z",
            "end_time": "2024-12-05T23:32:13Z"
        },
        {
            "priority": 10,
            "source": "youtube.com",
            "publisher": "arianespace",
            "title": "Volo VV25 – Sentinel-1C | Lanciatore Vega C I Arianespace",
            "description": "Il giovedì 5 dicembre 2024, il lanciatore Vega C (missione VV25) è decollato dal Centro spaziale della Guyana, nella Guyana francese, alle 18:20 ora locale (21:20 UTC, 22:20 CET). Vega C ha collocato ...",
            "feature_image": "https://i.ytimg.com/vi/F9iZgcvBq3o/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=F9iZgcvBq3o",
            "type": {
                "id": 1,
                "name": "Official Webcast"
            },
            "language": {
                "id": 8,
                "name": "Italian",
                "code": "it"
            },
            "start_time": "2024-12-05T20:42:26Z",
            "end_time": "2024-12-05T23:32:22Z"
        }
    ],
    "webcast_live": false,
    "timeline": [
        {
            "type": {
                "id": 9,
                "abbrev": "Ignition",
                "description": "Start of the engine ignition sequence"
            },
            "relative_time": "P0D"
        },
        {
            "type": {
                "id": 10,
                "abbrev": "Liftoff",
                "description": "First upwards movement of the rocket"
            },
            "relative_time": "PT4S"
        },
        {
            "type": {
                "id": 13,
                "abbrev": "Stage 2 Separation",
                "description": "Separation of the second stage from the first"
            },
            "relative_time": "PT2M22S"
        },
        {
            "type": {
                "id": 31,
                "abbrev": "SES",
                "description": "Start of the second engine"
            },
            "relative_time": "PT2M22S"
        },
        {
            "type": {
                "id": 74,
                "abbrev": "Stage 3 Separation",
                "description": "Third stage separates from the rocket."
            },
            "relative_time": "PT4M32S"
        },
        {
            "type": {
                "id": 75,
                "abbrev": "Stage 3 Ignition",
                "description": "Third stage engine ignites."
            },
            "relative_time": "PT4M39S"
        },
        {
            "type": {
                "id": 15,
                "abbrev": "Fairing Separation",
                "description": "Separation of the payload fairing"
            },
            "relative_time": "PT5M4S"
        },
        {
            "type": {
                "id": 74,
                "abbrev": "Stage 3 Separation",
                "description": "Third stage separates from the rocket."
            },
            "relative_time": "PT7M8S"
        },
        {
            "type": {
                "id": 32,
                "abbrev": "Kick Stage Ignition",
                "description": "Start of the kick stage engine"
            },
            "relative_time": "PT8M16S"
        },
        {
            "type": {
                "id": 33,
                "abbrev": "Kick Stage Cut-off",
                "description": "Cut-off of the kick stage engine"
            },
            "relative_time": "PT16M45S"
        },
        {
            "type": {
                "id": 73,
                "abbrev": "Kick Stage Burn",
                "description": "The kick stage conducts an engine burn in orbit."
            },
            "relative_time": "PT56M10S"
        },
        {
            "type": {
                "id": 73,
                "abbrev": "Kick Stage Burn",
                "description": "The kick stage conducts an engine burn in orbit."
            },
            "relative_time": "PT1H40M28S"
        },
        {
            "type": {
                "id": 35,
                "abbrev": "Payload Separation",
                "description": "Final deployment of the payload from the rocket"
            },
            "relative_time": "PT1H43M50S"
        },
        {
            "type": {
                "id": 73,
                "abbrev": "Kick Stage Burn",
                "description": "The kick stage conducts an engine burn in orbit."
            },
            "relative_time": "PT1H50M53S"
        }
    ],
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega-c_liftoff__image_20241209143139.jpg",
    "infographic": null,
    "program": [
        {
            "id": 22,
            "url": "https://ll.thespacedevs.com/2.2.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.2.0/agencies/27/?format=api",
                    "name": "European Space Agency",
                    "type": "Multinational"
                },
                {
                    "id": 1043,
                    "url": "https://ll.thespacedevs.com/2.2.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",
            "mission_patches": [],
            "type": {
                "id": 8,
                "name": "Earth Observation"
            }
        }
    ],
    "orbital_launch_attempt_count": 6828,
    "location_launch_attempt_count": 323,
    "pad_launch_attempt_count": 51,
    "agency_launch_attempt_count": 317,
    "orbital_launch_attempt_count_year": 239,
    "location_launch_attempt_count_year": 3,
    "pad_launch_attempt_count_year": 2,
    "agency_launch_attempt_count_year": 2,
    "pad_turnaround": "P91DT19H30M18S",
    "mission_patches": [
        {
            "id": 1074,
            "name": "Vega VV25",
            "priority": 10,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/vega2520vv25_mission_patch_20241204134904.png",
            "agency": {
                "id": 115,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/115/?format=api",
                "name": "Arianespace",
                "type": "Commercial"
            }
        }
    ],
    "type": "detailed"
}