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

EXAMPLE - /launch// 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'

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.0.0/launch/f0460950-3cb6-4889-8cbe-707f063d0565/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "f0460950-3cb6-4889-8cbe-707f063d0565",
    "url": "https://ll.thespacedevs.com/2.0.0/launch/f0460950-3cb6-4889-8cbe-707f063d0565/?format=api",
    "launch_library_id": null,
    "slug": "new-glenn-bluebird-block-2-4",
    "name": "New Glenn | BlueBird Block 2 #4",
    "status": {
        "id": 2,
        "name": "TBD"
    },
    "net": "2025-12-31T00:00:00Z",
    "window_end": "2025-12-31T00:00:00Z",
    "window_start": "2025-12-31T00:00:00Z",
    "inhold": false,
    "tbdtime": true,
    "tbddate": true,
    "probability": null,
    "holdreason": "",
    "failreason": "",
    "hashtag": null,
    "launch_service_provider": {
        "id": 141,
        "url": "https://ll.thespacedevs.com/2.0.0/agencies/141/?format=api",
        "name": "Blue Origin",
        "featured": true,
        "type": "Commercial",
        "country_code": "USA",
        "abbrev": "BO",
        "description": "Blue Origin is an American privately funded aerospace manufacturer and spaceflight services company set up by Amazon.com founder Jeff Bezos with its headquarters in Kent, Washington. The company is developing technologies to enable private human access to space with the goal to dramatically lower costs and increase reliability. Blue Origin currently launches its New Shepard sub-orbital vehicle from its West Texas launch site, they are currently constructing a launch pad for their orbital vehicle New Glenn at Cape Canaveral LC-36.",
        "administrator": "CEO: Jeff Bezos",
        "founding_year": "2000",
        "launchers": "New Shepard | New Glenn",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 32,
        "consecutive_successful_launches": 9,
        "successful_launches": 31,
        "failed_launches": 1,
        "pending_launches": 4,
        "consecutive_successful_landings": 3,
        "successful_landings": 29,
        "failed_landings": 3,
        "attempted_landings": 32,
        "info_url": "http://www.blueorigin.com/",
        "wiki_url": "http://en.wikipedia.org/wiki/Blue_Origin",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_logo_20190207032427.png",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_image_20190207032427.jpeg",
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_nation_20240222073724.jpg"
    },
    "rocket": {
        "id": 8411,
        "configuration": {
            "id": 138,
            "launch_library_id": 1001,
            "url": "https://ll.thespacedevs.com/2.0.0/config/launcher/138/?format=api",
            "name": "New Glenn",
            "description": "The New Glenn is a privately funded orbital launch vehicle in development by Blue Origin. New Glenn is described as a 7-meter-diameter (23 ft), two- or three-stage rocket.",
            "family": "",
            "full_name": "New Glenn",
            "manufacturer": {
                "id": 141,
                "url": "https://ll.thespacedevs.com/2.0.0/agencies/141/?format=api",
                "name": "Blue Origin",
                "featured": true,
                "type": "Commercial",
                "country_code": "USA",
                "abbrev": "BO",
                "description": "Blue Origin is an American privately funded aerospace manufacturer and spaceflight services company set up by Amazon.com founder Jeff Bezos with its headquarters in Kent, Washington. The company is developing technologies to enable private human access to space with the goal to dramatically lower costs and increase reliability. Blue Origin currently launches its New Shepard sub-orbital vehicle from its West Texas launch site, they are currently constructing a launch pad for their orbital vehicle New Glenn at Cape Canaveral LC-36.",
                "administrator": "CEO: Jeff Bezos",
                "founding_year": "2000",
                "launchers": "New Shepard | New Glenn",
                "spacecraft": "",
                "launch_library_url": null,
                "total_launch_count": 32,
                "consecutive_successful_launches": 9,
                "successful_launches": 31,
                "failed_launches": 1,
                "pending_launches": 4,
                "consecutive_successful_landings": 3,
                "successful_landings": 29,
                "failed_landings": 3,
                "attempted_landings": 32,
                "info_url": "http://www.blueorigin.com/",
                "wiki_url": "http://en.wikipedia.org/wiki/Blue_Origin",
                "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_logo_20190207032427.png",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_image_20190207032427.jpeg",
                "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/blue2520origin_nation_20240222073724.jpg"
            },
            "program": [],
            "variant": "",
            "alias": "",
            "min_stage": 2,
            "max_stage": 3,
            "length": 82.0,
            "diameter": 7.0,
            "maiden_flight": "2025-01-16",
            "launch_mass": null,
            "leo_capacity": 45000,
            "gto_capacity": 13000,
            "to_thrust": 17100,
            "apogee": null,
            "vehicle_range": null,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/new_glenn_on_lc_image_20240313170026.jpeg",
            "info_url": "https://www.blueorigin.com/new-glenn/",
            "wiki_url": "https://en.wikipedia.org/wiki/New_Glenn",
            "total_launch_count": 1,
            "consecutive_successful_launches": 1,
            "successful_launches": 1,
            "failed_launches": 0,
            "pending_launches": 4
        },
        "launcher_stage": [
            {
                "id": 619,
                "type": "Core",
                "reused": null,
                "launcher_flight_number": null,
                "launcher": {
                    "id": 152,
                    "url": "https://ll.thespacedevs.com/2.0.0/launcher/152/?format=api",
                    "details": "Booster serial number unknown.",
                    "flight_proven": false,
                    "serial_number": "Unknown NG",
                    "status": "N/A",
                    "image_url": null,
                    "successful_landings": null,
                    "attempted_landings": null,
                    "flights": null,
                    "last_launch_date": null,
                    "first_launch_date": null
                },
                "landing": null,
                "previous_flight_date": null,
                "turn_around_time_days": null,
                "previous_flight": null
            }
        ],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 6999,
        "launch_library_id": null,
        "name": "BlueBird Block 2 #4",
        "description": "AST SpaceMobile’s Block 2 BlueBird satellites are designed to deliver up to 10 times the bandwidth capacity of the BlueBird Block 1 satellites, required to achieve 24/7 continuous cellular broadband service coverage in the United States, with beams designed to support a capacity of up to 40 MHz, enabling peak data transmission speeds up to 120 Mbps, supporting voice, full data and video applications. The Block 2 BlueBirds, featuring as large as 2400 square foot communications arrays, will be the largest satellites ever commercially deployed in Low Earth orbit once launched.\r\n\r\nThis launch will feature 8 satellites.",
        "launch_designator": null,
        "type": "Communications",
        "orbit": {
            "id": 8,
            "name": "Low Earth Orbit",
            "abbrev": "LEO"
        }
    },
    "pad": {
        "id": 121,
        "url": "https://ll.thespacedevs.com/2.0.0/pad/121/?format=api",
        "agency_id": 161,
        "name": "Launch Complex 36A",
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Launch_Complex_36",
        "map_url": "https://www.google.com/maps?q=28.4705556,-80.542194",
        "latitude": "28.4705556",
        "longitude": "-80.542194",
        "location": {
            "id": 12,
            "url": "https://ll.thespacedevs.com/2.0.0/location/12/?format=api",
            "name": "Cape Canaveral SFS, FL, USA",
            "country_code": "USA",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg",
            "total_launch_count": 1020,
            "total_landing_count": 64
        },
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_121_20200803143231.jpg",
        "total_launch_count": 69
    },
    "infoURLs": [],
    "vidURLs": [],
    "webcast_live": false,
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/new_glenn_on_lc_image_20240313170026.jpeg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 7113,
    "location_launch_attempt_count": 1075,
    "pad_launch_attempt_count": 73,
    "agency_launch_attempt_count": 36,
    "orbital_launch_attempt_count_year": 264,
    "location_launch_attempt_count_year": 81,
    "pad_launch_attempt_count_year": 5,
    "agency_launch_attempt_count_year": 8
}