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/5792dbed-ea1a-4095-9c74-6d6de99b9827/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": "5792dbed-ea1a-4095-9c74-6d6de99b9827",
    "url": "https://ll.thespacedevs.com/2.0.0/launch/5792dbed-ea1a-4095-9c74-6d6de99b9827/?format=api",
    "launch_library_id": null,
    "slug": "eris-1-maiden-flight",
    "name": "Eris-1 | Maiden Flight",
    "status": {
        "id": 2,
        "name": "TBD"
    },
    "net": "2025-05-15T00:00:00Z",
    "window_end": "2025-05-15T00:00:00Z",
    "window_start": "2025-05-15T00:00:00Z",
    "inhold": false,
    "tbdtime": true,
    "tbddate": false,
    "probability": null,
    "holdreason": "",
    "failreason": "",
    "hashtag": null,
    "launch_service_provider": {
        "id": 188,
        "url": "https://ll.thespacedevs.com/2.0.0/agencies/188/?format=api",
        "name": "Gilmour Space Technologies",
        "featured": false,
        "type": "Private",
        "country_code": "AUS,SGP",
        "abbrev": "GST",
        "description": "Gilmour Space Technologies is a venture-funded Australian space company headquartered in Queensland, Australia that is developing hybrid-engine rockets and associated technology to support the development of a low-cost space launch vehicle.",
        "administrator": "CEO: Adam Gilmour",
        "founding_year": "2013",
        "launchers": "Eris",
        "spacecraft": "",
        "launch_library_url": null,
        "total_launch_count": 0,
        "consecutive_successful_launches": 0,
        "successful_launches": 0,
        "failed_launches": 0,
        "pending_launches": 1,
        "consecutive_successful_landings": 0,
        "successful_landings": 0,
        "failed_landings": 0,
        "attempted_landings": 0,
        "info_url": "https://www.gspacetech.com/",
        "wiki_url": "https://en.wikipedia.org/wiki/Gilmour_Space_Technologies",
        "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/gilmour_space_l_image_20250227072818.png",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/eris_on_the_lau_image_20250227073032.jpg",
        "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/gilmour_space_s_image_20250227072733.jpg"
    },
    "rocket": {
        "id": 8540,
        "configuration": {
            "id": 460,
            "launch_library_id": null,
            "url": "https://ll.thespacedevs.com/2.0.0/config/launcher/460/?format=api",
            "name": "Eris-1",
            "description": "Eris is a 3 stage orbital launch vehicle designed to deliver up to 305kg into a low earth orbit.",
            "family": "Eris",
            "full_name": "Eris Block 1",
            "manufacturer": {
                "id": 188,
                "url": "https://ll.thespacedevs.com/2.0.0/agencies/188/?format=api",
                "name": "Gilmour Space Technologies",
                "featured": false,
                "type": "Private",
                "country_code": "AUS,SGP",
                "abbrev": "GST",
                "description": "Gilmour Space Technologies is a venture-funded Australian space company headquartered in Queensland, Australia that is developing hybrid-engine rockets and associated technology to support the development of a low-cost space launch vehicle.",
                "administrator": "CEO: Adam Gilmour",
                "founding_year": "2013",
                "launchers": "Eris",
                "spacecraft": "",
                "launch_library_url": null,
                "total_launch_count": 0,
                "consecutive_successful_launches": 0,
                "successful_launches": 0,
                "failed_launches": 0,
                "pending_launches": 1,
                "consecutive_successful_landings": 0,
                "successful_landings": 0,
                "failed_landings": 0,
                "attempted_landings": 0,
                "info_url": "https://www.gspacetech.com/",
                "wiki_url": "https://en.wikipedia.org/wiki/Gilmour_Space_Technologies",
                "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/gilmour_space_l_image_20250227072818.png",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/eris_on_the_lau_image_20250227073032.jpg",
                "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/gilmour_space_s_image_20250227072733.jpg"
            },
            "program": [],
            "variant": "1",
            "alias": "",
            "min_stage": 3,
            "max_stage": 3,
            "length": 25.0,
            "diameter": 2.0,
            "maiden_flight": null,
            "launch_mass": null,
            "leo_capacity": 305,
            "gto_capacity": null,
            "to_thrust": null,
            "apogee": null,
            "vehicle_range": null,
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/eris_on_the_lau_image_20250227073032.jpg",
            "info_url": "https://www.gspacetech.com/launch",
            "wiki_url": "https://en.wikipedia.org/wiki/Gilmour_Space_Technologies#Eris",
            "total_launch_count": 0,
            "consecutive_successful_launches": 0,
            "successful_launches": 0,
            "failed_launches": 0,
            "pending_launches": 1
        },
        "launcher_stage": [],
        "spacecraft_stage": null
    },
    "mission": {
        "id": 7131,
        "launch_library_id": null,
        "name": "Maiden Flight",
        "description": "Maiden flight of Gilmour Space's orbital launch vehicle Eris.",
        "launch_designator": null,
        "type": "Test Flight",
        "orbit": {
            "id": 8,
            "name": "Low Earth Orbit",
            "abbrev": "LEO"
        }
    },
    "pad": {
        "id": 238,
        "url": "https://ll.thespacedevs.com/2.0.0/pad/238/?format=api",
        "agency_id": 188,
        "name": "Eris Pad",
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/Gilmour_Space_Technologies#Bowen_Orbital_Spaceport_(BOS)",
        "map_url": null,
        "latitude": "-19.958151",
        "longitude": "148.1129553",
        "location": {
            "id": 181,
            "url": "https://ll.thespacedevs.com/2.0.0/location/181/?format=api",
            "name": "Bowen Orbital Spaceport",
            "country_code": "AUS",
            "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_bowen_orbital_spaceport_20250227073649.jpg",
            "total_launch_count": 0,
            "total_landing_count": 0
        },
        "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_eris_pad_20250227074117.jpg",
        "total_launch_count": 0
    },
    "infoURLs": [],
    "vidURLs": [],
    "webcast_live": false,
    "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/eris_on_the_lau_image_20250227073032.jpg",
    "infographic": null,
    "program": [],
    "orbital_launch_attempt_count": 6949,
    "location_launch_attempt_count": 1,
    "pad_launch_attempt_count": 1,
    "agency_launch_attempt_count": 1,
    "orbital_launch_attempt_count_year": 100,
    "location_launch_attempt_count_year": 1,
    "pad_launch_attempt_count_year": 1,
    "agency_launch_attempt_count_year": 1
}