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/ab9e0dbd-5720-46f4-a514-1faa9f2303b4/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "ab9e0dbd-5720-46f4-a514-1faa9f2303b4",
    "url": "https://ll.thespacedevs.com/2.2.0/launch/ab9e0dbd-5720-46f4-a514-1faa9f2303b4/?format=api",
    "slug": "soyuz-21bfregat-m-egyptsat-a",
    "flightclub_url": null,
    "r_spacex_api_id": null,
    "name": "Soyuz 2.1b/Fregat-M | EgyptSat-A",
    "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-06-15T13:57:58Z",
    "updates": [],
    "net": "2019-02-21T16:47:14Z",
    "net_precision": {
        "id": 0,
        "name": "Second",
        "abbrev": "SEC",
        "description": "The T-0 is accurate to the second."
    },
    "window_end": "2019-02-21T16:47:14Z",
    "window_start": "2019-02-21T16:47:14Z",
    "probability": null,
    "weather_concerns": null,
    "holdreason": "",
    "failreason": "",
    "hashtag": null,
    "launch_service_provider": {
        "id": 63,
        "url": "https://ll.thespacedevs.com/2.2.0/agencies/63/?format=api",
        "name": "Russian Federal Space Agency (ROSCOSMOS)",
        "featured": true,
        "type": "Government",
        "country_code": "RUS",
        "abbrev": "RFSA",
        "description": "The Roscosmos State Corporation for Space Activities, commonly known as Roscosmos, is the governmental body responsible for the space science program of the Russian Federation and general aerospace research. Soyuz has many launch locations the Russian sites are Baikonur, Plesetsk and Vostochny however Ariane also purchases the vehicle and launches it from French Guiana.",
        "administrator": "Administrator: Yuri Borisov",
        "founding_year": "1992",
        "launchers": "Soyuz",
        "spacecraft": "Soyuz",
        "launch_library_url": null,
        "total_launch_count": 331,
        "consecutive_successful_launches": 55,
        "successful_launches": 320,
        "failed_launches": 11,
        "pending_launches": 4,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "http://en.roscosmos.ru/",
        "wiki_url": "http://en.wikipedia.org/wiki/Russian_Federal_Space_Agency",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_logo_20190207032459.png",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_image_20190207032459.jpeg",
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_nation_20230531052758.jpg"
    },
    "rocket": {
        "id": 2147,
        "configuration": {
            "id": 134,
            "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/134/?format=api",
            "name": "Soyuz 2.1b/Fregat-M",
            "active": true,
            "reusable": false,
            "description": "Soyuz-2, GRAU index 14A14, is the collective designation for the 21st-century version of the Russian Soyuz rocket. In its basic form, it is a three-stage carrier rocket for placing payloads into low Earth orbit. The first-stage boosters and two core stages feature uprated engines with improved injection systems, compared to the previous versions of the Soyuz. Digital flight control and telemetry systems allow the rocket to be launched from a fixed launch platform, whereas the launch platforms for earlier Soyuz rockets had to be rotated as the rocket could not perform a roll to change its heading in flight.",
            "family": "Soyuz",
            "full_name": "Soyuz 2.1b Fregat-M",
            "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": "Fregat-M",
            "alias": "",
            "min_stage": 4,
            "max_stage": 4,
            "length": 46.3,
            "diameter": 10.3,
            "maiden_flight": "2008-07-26",
            "launch_cost": "48500000",
            "launch_mass": 313,
            "leo_capacity": 8200,
            "gto_capacity": 3250,
            "to_thrust": 4150,
            "apogee": null,
            "vehicle_range": null,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_2.1b_image_20230802085331.jpg",
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/Soyuz-2",
            "total_launch_count": 32,
            "consecutive_successful_launches": 32,
            "successful_launches": 32,
            "failed_launches": 0,
            "pending_launches": 3,
            "attempted_landings": 0,
            "successful_landings": 0,
            "failed_landings": 0,
            "consecutive_successful_landings": 0
        },
        "launcher_stage": [],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 109,
        "name": "EgyptSat-A",
        "description": "EgyptSat-A (MisrSat A) is Egypt's third Earth remote-sounding satellite. The satellite is jointly built by Egypt's National Authority for Remote Sensing and Space Sciences together with RKK Energiya in Russia. The imaging payload was developed by OAO Peleng and NIRUP Geoinformatsionnye Sistemy in Belarus.\n\nThe satellite is an improved version of EgyptSat 2 and is also based on RKK Energiya's 559GK bus, which inherits technologies from their USP platform. The satellite features SPD-70 electric engines using Xenon. It features an improved opto-electronic system and onboard control system, high-speed on-board radio link and solar cells with increased efficiency.",
        "launch_designator": null,
        "type": "Earth Science",
        "orbit": {
            "id": 8,
            "name": "Low Earth Orbit",
            "abbrev": "LEO"
        },
        "agencies": [],
        "info_urls": [],
        "vid_urls": []
    },
    "pad": {
        "id": 20,
        "url": "https://ll.thespacedevs.com/2.2.0/pad/20/?format=api",
        "agency_id": null,
        "name": "31/6",
        "description": "",
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/Baikonur_Cosmodrome_Site_31",
        "map_url": "https://www.google.com/maps?q=45.996034,63.564003",
        "latitude": "45.996034",
        "longitude": "63.564003",
        "location": {
            "id": 15,
            "url": "https://ll.thespacedevs.com/2.2.0/location/15/?format=api",
            "name": "Baikonur Cosmodrome, Republic of Kazakhstan",
            "country_code": "KAZ",
            "description": "The Baikonur Cosmodrome is a spaceport operated by Russia within Kazakhstan. Located in the Kazakh city of Baikonur, it is the largest operational space launch facility in terms of area. All Russian crewed spaceflights are launched from Baikonur.",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_15_20200803142517.jpg",
            "timezone_name": "Asia/Qyzylorda",
            "total_launch_count": 1555,
            "total_landing_count": 0
        },
        "country_code": "KAZ",
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_20_20200803143516.jpg",
        "total_launch_count": 422,
        "orbital_launch_attempt_count": 422
    },
    "infoURLs": [],
    "vidURLs": [],
    "webcast_live": false,
    "timeline": [],
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_2.1b_image_20230802085331.jpg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 5830,
    "location_launch_attempt_count": 1496,
    "pad_launch_attempt_count": 376,
    "agency_launch_attempt_count": 280,
    "orbital_launch_attempt_count_year": 10,
    "location_launch_attempt_count_year": 1,
    "pad_launch_attempt_count_year": 1,
    "agency_launch_attempt_count_year": 1,
    "pad_turnaround": "P226DT18H55M40S",
    "mission_patches": [],
    "type": "detailed"
}