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/10be093a-ad74-46e6-a26c-37626e6d72b7/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "10be093a-ad74-46e6-a26c-37626e6d72b7",
    "url": "https://ll.thespacedevs.com/2.2.0/launch/10be093a-ad74-46e6-a26c-37626e6d72b7/?format=api",
    "slug": "falcon-1-razaksat",
    "flightclub_url": null,
    "r_spacex_api_id": null,
    "name": "Falcon 1 | RazakSAT",
    "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-13T18:00:54Z",
    "updates": [],
    "net": "2009-07-14T03:36:00Z",
    "net_precision": {
        "id": 1,
        "name": "Minute",
        "abbrev": "MIN",
        "description": "The T-0 is accurate to the minute."
    },
    "window_end": "2009-07-14T03:36:00Z",
    "window_start": "2009-07-14T03:36:00Z",
    "probability": null,
    "weather_concerns": null,
    "holdreason": "",
    "failreason": "",
    "hashtag": null,
    "launch_service_provider": {
        "id": 121,
        "url": "https://ll.thespacedevs.com/2.2.0/agencies/121/?format=api",
        "name": "SpaceX",
        "featured": true,
        "type": "Commercial",
        "country_code": "USA",
        "abbrev": "SpX",
        "description": "Space Exploration Technologies Corp., known as SpaceX, is an American aerospace manufacturer and space transport services company headquartered in Hawthorne, California. It was founded in 2002 by entrepreneur Elon Musk with the goal of reducing space transportation costs and enabling the colonization of Mars. SpaceX operates from many pads, on the East Coast of the US they operate from SLC-40 at Cape Canaveral Space Force Station and historic LC-39A at Kennedy Space Center. They also operate from SLC-4E at Vandenberg Space Force Base, California, usually for polar launches. Another launch site is being developed at Boca Chica, Texas.",
        "administrator": "CEO: Elon Musk",
        "founding_year": "2002",
        "launchers": "Falcon | Starship",
        "spacecraft": "Dragon",
        "launch_library_url": null,
        "total_launch_count": 510,
        "consecutive_successful_launches": 33,
        "successful_launches": 496,
        "failed_launches": 14,
        "pending_launches": 117,
        "consecutive_successful_landings": 79,
        "successful_landings": 457,
        "failed_landings": 26,
        "attempted_landings": 482,
        "info_url": "http://www.spacex.com/",
        "wiki_url": "http://en.wikipedia.org/wiki/SpaceX",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_logo_20220826094919.png",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_image_20190207032501.jpeg",
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_nation_20230531064544.jpg"
    },
    "rocket": {
        "id": 1421,
        "configuration": {
            "id": 133,
            "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/133/?format=api",
            "name": "Falcon 1",
            "active": false,
            "reusable": false,
            "description": "The Falcon 1 was the first launch vehicle developed and manufactured by SpaceX in 2006. It is an expendable, two stage rocket where each stage is powered by a single LOX/RP1 engine.",
            "family": "Falcon",
            "full_name": "Falcon 1",
            "manufacturer": {
                "id": 121,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/121/?format=api",
                "name": "SpaceX",
                "featured": true,
                "type": "Commercial",
                "country_code": "USA",
                "abbrev": "SpX",
                "description": "Space Exploration Technologies Corp., known as SpaceX, is an American aerospace manufacturer and space transport services company headquartered in Hawthorne, California. It was founded in 2002 by entrepreneur Elon Musk with the goal of reducing space transportation costs and enabling the colonization of Mars. SpaceX operates from many pads, on the East Coast of the US they operate from SLC-40 at Cape Canaveral Space Force Station and historic LC-39A at Kennedy Space Center. They also operate from SLC-4E at Vandenberg Space Force Base, California, usually for polar launches. Another launch site is being developed at Boca Chica, Texas.",
                "administrator": "CEO: Elon Musk",
                "founding_year": "2002",
                "launchers": "Falcon | Starship",
                "spacecraft": "Dragon",
                "launch_library_url": null,
                "total_launch_count": 510,
                "consecutive_successful_launches": 33,
                "successful_launches": 496,
                "failed_launches": 14,
                "pending_launches": 117,
                "consecutive_successful_landings": 79,
                "successful_landings": 457,
                "failed_landings": 26,
                "attempted_landings": 482,
                "info_url": "http://www.spacex.com/",
                "wiki_url": "http://en.wikipedia.org/wiki/SpaceX",
                "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_logo_20220826094919.png",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_image_20190207032501.jpeg",
                "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_nation_20230531064544.jpg"
            },
            "program": [],
            "variant": "1",
            "alias": "",
            "min_stage": 2,
            "max_stage": 2,
            "length": 22.25,
            "diameter": 1.7,
            "maiden_flight": "2006-03-24",
            "launch_cost": "7000000",
            "launch_mass": 33,
            "leo_capacity": 470,
            "gto_capacity": null,
            "to_thrust": 454,
            "apogee": null,
            "vehicle_range": null,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon_image_20190222030438.jpeg",
            "info_url": null,
            "wiki_url": "https://en.wikipedia.org/wiki/Falcon_1",
            "total_launch_count": 5,
            "consecutive_successful_launches": 2,
            "successful_launches": 2,
            "failed_launches": 3,
            "pending_launches": 0,
            "attempted_landings": 2,
            "successful_landings": 0,
            "failed_landings": 2,
            "consecutive_successful_landings": 0
        },
        "launcher_stage": [
            {
                "id": 362,
                "type": "Core",
                "reused": false,
                "launcher_flight_number": 1,
                "launcher": {
                    "id": 7,
                    "url": "https://ll.thespacedevs.com/2.2.0/launcher/7/?format=api",
                    "details": "Booster expended during the second successful flight of Falcon 1.",
                    "flight_proven": true,
                    "serial_number": "F1 B0005",
                    "status": "lost",
                    "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/7_image_20230707190228.jpg",
                    "successful_landings": 0,
                    "attempted_landings": 0,
                    "flights": 1,
                    "last_launch_date": "2009-07-14T03:36:00Z",
                    "first_launch_date": "2009-07-14T03:36:00Z"
                },
                "landing": {
                    "id": 1188,
                    "attempt": false,
                    "success": null,
                    "description": "Booster was expended during its first flight.",
                    "downrange_distance": null,
                    "location": {
                        "id": 18,
                        "name": "Pacific Ocean",
                        "abbrev": "PAC",
                        "description": "Pacific Ocean",
                        "location": null,
                        "successful_landings": 46
                    },
                    "type": {
                        "id": 8,
                        "name": "Expended",
                        "abbrev": "EXP",
                        "description": "Vehicle did not perform any landing operations after launch"
                    }
                },
                "previous_flight_date": null,
                "turn_around_time_days": null,
                "previous_flight": null
            }
        ],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 6462,
        "name": "RazakSAT",
        "description": "RazakSAT is a Malaysian Earth observation satellite carrying a high-resolution camera. It was the first and only operational satellite to be put in orbit by SpaceX's Falcon 1.",
        "launch_designator": null,
        "type": "Earth Science",
        "orbit": {
            "id": 8,
            "name": "Low Earth Orbit",
            "abbrev": "LEO"
        },
        "agencies": [],
        "info_urls": [],
        "vid_urls": []
    },
    "pad": {
        "id": 107,
        "url": "https://ll.thespacedevs.com/2.2.0/pad/107/?format=api",
        "agency_id": null,
        "name": "Omelek Island",
        "description": null,
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/Omelek_Island",
        "map_url": "https://www.google.com/maps?q=9.047861,167.743",
        "latitude": "9.047861",
        "longitude": "167.743",
        "location": {
            "id": 142,
            "url": "https://ll.thespacedevs.com/2.2.0/location/142/?format=api",
            "name": "Ronald Reagan Ballistic Missile Defense Test Site, Kwajalein Atoll, Marshall Islands",
            "country_code": "MHL",
            "description": "The Ronald Reagan Ballistic Missile Defense Test Site is a missile test range in Marshall Islands. It covers about 750,000 square miles (1,900,000 km2) and includes rocket launch sites at the Kwajalein Atoll (on multiple islands), Wake Island, and Aur Atoll. It primarily functions as a test facility for U.S. missile defense and space research programs.",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_142_20200803142511.jpg",
            "timezone_name": "Pacific/Tarawa",
            "total_launch_count": 5,
            "total_landing_count": 0
        },
        "country_code": "MHL",
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_107_20200803143450.jpg",
        "total_launch_count": 5,
        "orbital_launch_attempt_count": 5
    },
    "infoURLs": [
        {
            "priority": 0,
            "source": null,
            "title": "FALCON 1 | FLIGHT 5",
            "description": "Falcon 1 Successfully Delivers RazakSAT Satellite to OrbitHawthorne, CA – July 15, 2009 – Space Exploration Technologies (SpaceX) announces the successful launch of Falcon 1 Flight 5 launch vehicle and the precision placement of Malaysia's RazakSAT into Earth orbit.“This marks another successful lau...",
            "feature_image": null,
            "url": "http://www.spacex.com/news/2013/02/12/falcon-1-flight-5",
            "type": null,
            "language": null
        },
        {
            "priority": 0,
            "source": "en.wikipedia.org",
            "title": "Falcon 1 - Wikipedia",
            "description": "Falcon 1 was a small-lift launch vehicle that was operated from 2006 to 2009[5] by SpaceX, an American aerospace manufacturer. On 28 September 2008, Falcon 1 became the first privately developed fully liquid-fueled launch vehicle to go into orbit around the Earth.[6]: 203 [7]\n\nThe two-stage-to-orbit...",
            "feature_image": null,
            "url": "https://en.wikipedia.org/wiki/Falcon_1#Fifth_flight",
            "type": null,
            "language": null
        }
    ],
    "vidURLs": [
        {
            "priority": 0,
            "source": null,
            "publisher": null,
            "title": "SpaceX Falcon 1 Flight 5 - RazakSAT launch [HQ]",
            "description": "Falcon 1, a two-stage, liquid oxygen/rocket-grade kerosene vehicle designed and manufactured by SpaceX, lifted off Monday, July 13, at 8:35 pm (PDT). Lift of...",
            "feature_image": "https://i.ytimg.com/vi/GHs6QyB5GWM/hqdefault.jpg",
            "url": "https://www.youtube.com/watch?v=GHs6QyB5GWM",
            "type": null,
            "language": null,
            "start_time": null,
            "end_time": null
        },
        {
            "priority": 0,
            "source": null,
            "publisher": null,
            "title": "SpaceX - Falcon 1 Flight 5, RazakSAT payload (T-2 to SECO)",
            "description": "Launch of the RazakSAT satellite via a Falcon 1 rocket",
            "feature_image": "https://i.ytimg.com/vi/WTFlFFrfEB0/hqdefault.jpg",
            "url": "https://www.youtube.com/watch?v=WTFlFFrfEB0",
            "type": null,
            "language": null,
            "start_time": null,
            "end_time": null
        }
    ],
    "webcast_live": false,
    "timeline": [],
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon_image_20190222030438.jpeg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 4993,
    "location_launch_attempt_count": 5,
    "pad_launch_attempt_count": 5,
    "agency_launch_attempt_count": 5,
    "orbital_launch_attempt_count_year": 39,
    "location_launch_attempt_count_year": 1,
    "pad_launch_attempt_count_year": 1,
    "agency_launch_attempt_count_year": 1,
    "pad_turnaround": "P288DT4H21M",
    "mission_patches": [
        {
            "id": 571,
            "name": "Falcon 1 | RazakSAT Patch",
            "priority": 10,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/falcon2520125_mission_patch_20211031044201.png",
            "agency": {
                "id": 121,
                "url": "https://ll.thespacedevs.com/2.2.0/agencies/121/?format=api",
                "name": "SpaceX",
                "type": "Commercial"
            }
        }
    ],
    "type": "detailed"
}