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/9157dcc9-b018-429b-b03a-2f08a1876cdd/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "9157dcc9-b018-429b-b03a-2f08a1876cdd",
    "url": "https://ll.thespacedevs.com/2.2.0/launch/9157dcc9-b018-429b-b03a-2f08a1876cdd/?format=api",
    "slug": "soyuz-stbfregat-galileo-l5-foc-fm05-fm06",
    "flightclub_url": null,
    "r_spacex_api_id": null,
    "name": "Soyuz STB/Fregat | Galileo L5 (FOC FM05-FM06)",
    "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-04-28T05:43:30Z",
    "updates": [],
    "net": "2015-09-11T02:08:10Z",
    "net_precision": null,
    "window_end": "2015-09-11T02:08:10Z",
    "window_start": "2015-09-11T02:08:10Z",
    "probability": -1,
    "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": 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": 1863,
        "configuration": {
            "id": 171,
            "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/171/?format=api",
            "name": "Soyuz STB",
            "active": true,
            "reusable": false,
            "description": "The 2.1b version adds an upgraded engine (RD-0124) with improved performance to the second stage. First launch took place from Plesetsk Cosmodrome Site 43 on 26 July 2008 with a classified military payload.\r\n\r\nThe 2.1b/ST version is sometimes called Soyuz ST-B.",
            "family": "Soyuz",
            "full_name": "Soyuz STB Fregat",
            "manufacturer": {
                "id": 111,
                "url": "https://ll.thespacedevs.com/2.2.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": "STB/Fregat",
            "alias": "",
            "min_stage": 3,
            "max_stage": 3,
            "length": 46.3,
            "diameter": 2.95,
            "maiden_flight": "2011-10-21",
            "launch_cost": null,
            "launch_mass": 312,
            "leo_capacity": 8200,
            "gto_capacity": 3250,
            "to_thrust": null,
            "apogee": null,
            "vehicle_range": null,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_stb_image_20211130181029.jpeg",
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/Soyuz-2_(rocket)",
            "total_launch_count": 14,
            "consecutive_successful_launches": 11,
            "successful_launches": 13,
            "failed_launches": 1,
            "pending_launches": 0,
            "attempted_landings": 0,
            "successful_landings": 0,
            "failed_landings": 0,
            "consecutive_successful_landings": 0
        },
        "launcher_stage": [],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 6812,
        "name": "Galileo L5 (FOC FM05-FM06)",
        "description": "The 5th and 6th Full Operational Capability satellites will be the 9th and 10th Galileo satellites launched, alongside the 4 FOC and 4 IOV spacecraft already in orbit. The Galileo constellation is ESA's satellite navigation system and is expected to be completed by 2020. Galileo will provide Europe with an alternative to the American GPS and Russian GLONASS constellations, but will be interoperable with both systems.",
        "launch_designator": null,
        "type": "Navigation",
        "orbit": {
            "id": 12,
            "name": "Medium Earth Orbit",
            "abbrev": "MEO"
        },
        "agencies": [],
        "info_urls": [],
        "vid_urls": []
    },
    "pad": {
        "id": 81,
        "url": "https://ll.thespacedevs.com/2.2.0/pad/81/?format=api",
        "agency_id": 115,
        "name": "Soyuz Launch Complex",
        "description": "The Ensemble de Lancement Soyouz (ELS)  is a launch complex at the Guiana Space Centre in Kourou/Sinnamary, French Guiana. It was used by Soyuz-ST rockets: modified versions of the Soyuz-2 optimised for launch from Kourou under Soyuz at the Guiana Space Centre programme.",
        "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.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": 325,
            "total_landing_count": 0
        },
        "country_code": "GUF",
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_81_20200803143601.jpg",
        "total_launch_count": 26,
        "orbital_launch_attempt_count": 26
    },
    "infoURLs": [],
    "vidURLs": [
        {
            "priority": 0,
            "source": null,
            "publisher": null,
            "title": "Galileo launch (sat 9 & 10) - liftoff",
            "description": "Liftoff of the Soyuz rocket carrying Galileo satellites 9 & 10 from Europe’s Spaceport in French Guiana on 11 September 2015.",
            "feature_image": "https://i.ytimg.com/vi/KnvDwvH3i44/maxresdefault.jpg",
            "url": "https://www.youtube.com/watch?v=KnvDwvH3i44",
            "type": null,
            "language": null,
            "start_time": null,
            "end_time": null
        }
    ],
    "webcast_live": false,
    "timeline": [],
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_stb_image_20211130181029.jpeg",
    "infographic": null,
    "program": [
        {
            "id": 30,
            "url": "https://ll.thespacedevs.com/2.2.0/program/30/?format=api",
            "name": "Galileo",
            "description": "Galileo is a global navigation satellite system (GNSS) that went live in 2016, created by the European Union through the European Space Agency (ESA), operated by the European Union Agency for the Space Programme (EUSPA).",
            "agencies": [
                {
                    "id": 27,
                    "url": "https://ll.thespacedevs.com/2.2.0/agencies/27/?format=api",
                    "name": "European Space Agency",
                    "type": "Multinational"
                }
            ],
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/galileo_program_20231230110547.png",
            "start_date": "2011-10-21T10:30:00Z",
            "end_date": null,
            "info_url": "https://www.gsc-europa.eu/",
            "wiki_url": "https://en.wikipedia.org/wiki/Galileo_(satellite_navigation)",
            "mission_patches": [],
            "type": {
                "id": 4,
                "name": "Navigation Constellation"
            }
        }
    ],
    "orbital_launch_attempt_count": 5490,
    "location_launch_attempt_count": 251,
    "pad_launch_attempt_count": 12,
    "agency_launch_attempt_count": 236,
    "orbital_launch_attempt_count_year": 48,
    "location_launch_attempt_count_year": 8,
    "pad_launch_attempt_count_year": 2,
    "agency_launch_attempt_count_year": 8,
    "pad_turnaround": "P167DT4H21M52S",
    "mission_patches": [],
    "type": "detailed"
}