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/d74f2e7b-a8b7-4d8f-8ecd-193e73937664/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "d74f2e7b-a8b7-4d8f-8ecd-193e73937664",
    "url": "https://ll.thespacedevs.com/2.2.0/launch/d74f2e7b-a8b7-4d8f-8ecd-193e73937664/?format=api",
    "slug": "vega-c-space-rider",
    "flightclub_url": null,
    "r_spacex_api_id": null,
    "name": "Vega-C | Space Rider",
    "status": {
        "id": 2,
        "name": "To Be Determined",
        "abbrev": "TBD",
        "description": "Current date is a placeholder or rough estimation based on unreliable or interpreted sources."
    },
    "last_updated": "2024-11-09T11:31:59Z",
    "updates": [
        {
            "id": 8544,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
            "comment": "NET 2027",
            "info_url": "https://avio-data.teleborsa.it/2024%2FAvio-S.p.A.-Half-Year-Report-at-June-30%2C-2024-(ENG)_20240911_080530.pdf",
            "created_by": "Nosu",
            "created_on": "2024-09-11T20:33:00Z"
        },
        {
            "id": 5006,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
            "comment": "Q3 2025",
            "info_url": "https://www.nasaspaceflight.com/2023/08/space-rider-update/",
            "created_by": "Nosu",
            "created_on": "2023-08-27T07:46:38Z"
        },
        {
            "id": 2834,
            "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg",
            "comment": "NET Late 2024",
            "info_url": "https://www.esa.int/Enabling_Support/Space_Transportation/Space_Rider/To_orbit_and_back_with_Space_Rider",
            "created_by": "Nosu",
            "created_on": "2022-11-17T10:10:15Z"
        }
    ],
    "net": "2027-12-31T00:00:00Z",
    "net_precision": {
        "id": 14,
        "name": "Year",
        "abbrev": "Y",
        "description": "The T-0 is expected in the given year."
    },
    "window_end": "2027-12-31T00:00:00Z",
    "window_start": "2027-12-31T00:00:00Z",
    "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": 2491,
        "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": {
            "id": 865,
            "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/865/?format=api",
            "mission_end": null,
            "destination": "Low Earth Orbit",
            "launch_crew": [],
            "onboard_crew": [],
            "landing_crew": [],
            "spacecraft": {
                "id": 603,
                "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/603/?format=api",
                "name": "Space Rider",
                "serial_number": null,
                "is_placeholder": false,
                "in_space": false,
                "time_in_space": "P0D",
                "time_docked": "P0D",
                "flights_count": 0,
                "mission_ends_count": 0,
                "status": {
                    "id": 5,
                    "name": "Under construction"
                },
                "description": "European reusable spaceplane",
                "spacecraft_config": {
                    "id": 44,
                    "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/44/?format=api",
                    "name": "Space Rider",
                    "type": {
                        "id": 3,
                        "name": "Spaceplane"
                    },
                    "agency": {
                        "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",
                        "parent": null,
                        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/esa_patch_float_image_20250211192109.png",
                        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/european2520space2520agency_logo_20221130101442.png"
                    },
                    "in_use": false,
                    "capability": "The spacecraft is designed to conduct missions up to two months long in low Earth orbit with up to 600 kg of cargo.",
                    "history": "Development of Space Rider is led by the Italian Programme for Reusable In-orbit Demonstrator in Europe (PRIDE programme) in collaboration with ESA, and is the continuation of the Intermediate eXperimental Vehicle (IXV) experience, launched on 11 February 2015. Contracts for construction of the vehicle and ground infrastructure were signed in December 2020.",
                    "details": "The Space Rider (Space Reusable Integrated Demonstrator for Europe Return) is an uncrewed orbital lifting body spaceplane developed by the European Space Agency (ESA) to provide affordable and routine access to space.",
                    "maiden_flight": null,
                    "height": 8.044,
                    "diameter": null,
                    "human_rated": false,
                    "crew_capacity": null,
                    "payload_capacity": 600,
                    "payload_return_capacity": 600,
                    "flight_life": "Up to two months in LEO",
                    "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/space_rider_in__image_20241109112332.png",
                    "nation_url": null,
                    "wiki_link": "https://en.wikipedia.org/wiki/Space_Rider",
                    "info_link": "https://www.esa.int/Enabling_Support/Space_Transportation/Space_Rider"
                }
            },
            "landing": {
                "id": 1480,
                "attempt": true,
                "success": null,
                "description": "Space Rider will perform a parafoil-guided horizontal landing on the Santa Maria island in the Azores archipelago.",
                "downrange_distance": null,
                "location": {
                    "id": 52,
                    "name": "Santa Maria",
                    "abbrev": "SM",
                    "description": "Santa Maria is an island in the eastern group of the Azores archipelago (south of the island of São Miguel) and the southernmost island in the Azores.",
                    "location": null,
                    "successful_landings": 0
                },
                "type": {
                    "id": 10,
                    "name": "Parafoil Landing",
                    "abbrev": "PFL",
                    "description": "Unpowered landing using parafoil(s)."
                }
            },
            "docking_events": []
        }
    },
    "mission": {
        "id": 6990,
        "name": "Space Rider",
        "description": "Maiden flight of the European Space Rider (Space Reusable Integrated Demonstrator for Europe Return).",
        "launch_designator": null,
        "type": "Technology",
        "orbit": {
            "id": 8,
            "name": "Low Earth Orbit",
            "abbrev": "LEO"
        },
        "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": [
            {
                "priority": 10,
                "source": "www.esa.int",
                "title": "Space Rider",
                "description": "Space Rider is an uncrewed robotic laboratory about the size of two minivans. After launch on Vega-C it will stay in low orbit for about two months. Experiments inside its cargo bay will allow technology demonstration and benefit research in pharmaceutics, biomedicine, biology and physical science. ...",
                "feature_image": null,
                "url": "https://www.esa.int/Enabling_Support/Space_Transportation/Space_Rider",
                "type": {
                    "id": 1,
                    "name": "Official Page"
                },
                "language": {
                    "id": 1,
                    "name": "English",
                    "code": "en"
                }
            }
        ],
        "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": [],
    "webcast_live": false,
    "timeline": [],
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega-c_image_20220713154437.jpg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 7224,
    "location_launch_attempt_count": 361,
    "pad_launch_attempt_count": 71,
    "agency_launch_attempt_count": 353,
    "orbital_launch_attempt_count_year": 34,
    "location_launch_attempt_count_year": 3,
    "pad_launch_attempt_count_year": 2,
    "agency_launch_attempt_count_year": 2,
    "pad_turnaround": "P365D",
    "mission_patches": [],
    "type": "detailed"
}